記録の開始と管理

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

記録はバックグラウンドのデーモン（launchd 常駐エージェント）が行います。制御はすべて短いコマンドひとつです。

記録を開始する

tadoru start

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

フォアグラウンドで試す

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

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

record はパイプ実験や検証に向いています。ファイルに書く場合は --out events.jsonl を使います。常用の記録は start を使ってください。

状態を確認する

tadoru status
tadoru 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/tadoru/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 が便利です。

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

データのライフサイクル

• 保存先はローカルの SQLite ストア ~/.local/state/tadoru/store.sqlite のみです（--store で変更可能）。
• 既定で 48 時間より古いイベントは自動削除されます（retention_hours、設定）。
• 手動で削除する場合は purge を使います。

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