---
title: 記録の開始と管理
description: デーモンの起動・停止・一時停止・状態確認と、保存データのライフサイクル。
---

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

| コマンド | 動作 |
| --- | --- |
| `tadoru start` | launchd に登録し、バックグラウンド記録を開始 |
| `tadoru stop` | 記録を停止し launchd から解除（**データは残ります**） |
| `tadoru pause --for 30m` | 一時停止。`--for` 省略時は `resume` するまで無期限 |
| `tadoru resume` | 一時停止から再開 |
| `tadoru status` | 稼働状態・イベント件数・ストア情報の確認 |

## 記録を開始する

```bash
tadoru start
```

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

### フォアグラウンドで試す

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

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

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

## 状態を確認する

```bash
tadoru status
tadoru status --json   # agent・スクリプト向け
```

```json
{
  "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` が便利です。

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

:::note
特定のアプリ・サイトを常に記録対象から外したい場合は、一時停止ではなく[フィルタ](/ja/guides/filters)を使ってください。ストアに書き込まれる前に破棄されます。
:::

## データのライフサイクル

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

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

:::warning
`purge` は破壊的操作です。`--all` には確認プロンプトがあります（`--quiet` で抑制可能）。
:::