データの取り出し
記録した行動を読み出す 3 つの方法 — timeline・query・export の使い分け。
記録されたデータは 3 つの形で読み出せます。
| コマンド | 形 | 向いている用途 |
|---|---|---|
timeline |
セッション構造の要約（token budget 付き） | LLM・agent に渡す |
query |
条件で絞った生イベント | 精密な検索・検証・独自処理 |
export |
範囲内の生イベント全部 | バックアップ・外部パイプライン |
時間表現
--since / --until が受け取る値：
| 形式 | 例 | 意味 |
|---|---|---|
| 相対 | 15m 2h 1d 1w |
現在からの遡り。単位は s m h d w |
| 絶対 | 2026-08-16T09:00:00Z |
RFC3339 タイムスタンプ |
| キーワード | now |
現在時刻（主に --until 用） |
--until の既定は now。--since の既定はコマンドごとに timeline = 1h、query = 15m、export = 24h です。
timeline — LLM-ready な要約
生イベントをセッション分割・重複除去・coalesce し、token budget に収めて出力します。
zanei timeline --since 1h # Markdown、約 4000 トークン
zanei timeline --since 30m --format json --granularity fine
zanei timeline --since 1d --token-budget 8000| フラグ | 説明 |
|---|---|
--since / --until |
対象範囲（既定 --since 1h） |
--format |
md（既定、LLM-ready Markdown）/ json（構造化） |
--token-budget <N> |
概算トークン上限（既定 4000）。超過分は粒度を粗くして収めます |
--granularity |
coarse（既定、セッション単位）/ fine（操作単位まで） |
--format json では構造化された形が得られます：
{
"range": { "since": "2026-08-16T08:00:00Z", "until": "2026-08-16T09:00:00Z" },
"token_estimate": 3810,
"truncated": false,
"sessions": [
{
"start": "2026-08-16T08:12:00Z", "end": "2026-08-16T08:31:00Z",
"app": "Safari", "title_summary": "PR #42 のレビュー",
"activities": ["GitHub で 3 ファイルを閲覧", "コメントを 2 件記入"],
"event_ids": ["evt_01J...", "evt_01J..."]
}
]
}各セッションの event_ids は背後の生イベントへの参照です。要約から query で掘り下げられます。
query — 生イベント
zanei query --since 15m --types browser.navigate,app.activate
zanei query --since 2h --app Safari --format json --limit 500
zanei query --since 1d --bundle-id com.google.Chrome --types "browser.*"| フラグ | 説明 |
|---|---|
--since / --until |
対象範囲（既定 --since 15m） |
--types |
イベント型のカンマ区切り。末尾ワイルドカード browser.* 可 |
--app / --bundle-id |
アプリ名 / バンドル ID で絞り込み |
--limit <N> |
最大件数（既定 500） |
--format |
jsonl（既定）/ json / table |
これらは query-time フィルタです — 読み出しを絞るだけで、記録対象は変わりません。記録側の境界はフィルタを参照。
export — 一括ダンプ
zanei export --since 24h --format jsonl --out dump.jsonl範囲内の全生イベントをダンプします（バックアップ・外部処理用）。既定範囲は --since 24h です。
レシピ
作業再開時の文脈復元（skill ファイルに同梱される一行。token budget は既定値の 4000 のまま）：
zanei timeline --since 2h --format mdagent が記録の稼働を確認する：
zanei status --json今日 Chrome で見ていたものだけを引く：
zanei query --since 1d --app "Google Chrome" --types browser.navigate --format json