記録の開始と管理

デーモンの起動・停止・一時停止・状態確認と、保存データのライフサイクル。

記録はバックグラウンドのデーモン（launchd エージェント）が行い、次のコマンドで制御します。

記録を開始する

zanei start

起動時に権限をチェックし、不足があれば記録を開始せず、終了コード 3 で不足内容を案内します（権限ガイド）。

フォアグラウンドで試す

デーモン化せずに動きを確かめたいときは 2 つの方法があります。

zanei start --foreground   # デーモンと同じ構成で前面実行（開発・デバッグ用）
zanei record --stream      # 生イベントを NDJSON で stdout に流す

record はパイプ処理や検証向けです。ファイルに書く場合は --out events.jsonl を使います。常用の記録は start です。

状態を確認する

zanei status
zanei status --json   # agent・スクリプト向け

{
  "running": true,
  "paused": false,
  "since": "2026-08-16T08:00:00Z",
  "uptime_s": 3600,
  "events_captured": 12345,
  "last_event_ts": "2026-08-16T08:59:58Z",
  "store": { "path": "~/.local/state/zanei/store.sqlite", "size_bytes": 5242880, "retention_hours": 48, "oldest_event_ts": "2026-08-14T09:00:00Z" },
  "capture": { "sources": ["app", "window", "ui", "input", "browser"], "text_content": false },
  "permissions_ok": true
}

対象デーモンが存在しない場合（status / stop など）は終了コード 4 を返します。

一時停止と再開

会議や画面共有の間だけ記録を止めるには pause を使います。

zanei pause --for 30m   # 30分後に自動で再開
zanei pause             # resume するまで無期限に停止
zanei resume

データのライフサイクル

• 保存先はローカルの SQLite ストア ~/.local/state/zanei/store.sqlite のみです（--store で変更可能）。
• 既定で 48 時間より古いイベントは起動時と定期実行で purge され、読み取り結果からも除外されます（retention_hours、設定）。
• 手動で削除する場合は purge を使います。

zanei purge --before 24h   # 24時間より古いイベントを削除
zanei purge --all          # 全削除（確認プロンプトあり）