# Tadoru

> Record your on-screen activity locally and turn it into LLM-ready timelines for AI agents.

## Docs

- [What is Tadoru?](https://tadoru.dev/): An open-source tool that records your on-screen activity locally and turns it into LLM-ready timelines for AI agents.
- [Quickstart](https://tadoru.dev/quickstart): From install to your first timeline and agent integration. Takes about five minutes.
- [FAQ](https://tadoru.dev/faq): Common questions about privacy, browser support, data access, platforms, and troubleshooting.

## Guides

- [macOS permissions](https://tadoru.dev/guides/permissions): The TCC permissions Tadoru uses, and how tadoru doctor diagnoses and guides you through granting them.
- [Recording](https://tadoru.dev/guides/recording): Starting, stopping, and pausing the daemon, checking status, and the lifecycle of stored data.
- [Privacy model](https://tadoru.dev/guides/privacy): What gets recorded, what never does, and the layered defenses behind Tadoru's safe-by-default design.
- [Filters](https://tadoru.dev/guides/filters): Allow and deny lists that discard events before they are written — the privacy boundary of Tadoru.
- [Retrieving data](https://tadoru.dev/guides/timeline): The three ways to read recorded activity — timeline, query, and export — and how to choose between them.

## Agent integration

- [Agent integration](https://tadoru.dev/agents): How Tadoru plugs into AI agents — the two surfaces, the skill instruction layer, which agents are covered, and what agents can (and cannot) do.
- [Setup](https://tadoru.dev/agents/setup): Set up Tadoru with native integration or printed instructions for manual placement.

## Reference

- [CLI reference](https://tadoru.dev/reference/cli): Every tadoru command, flag, shared convention, and exit code.
- [MCP server](https://tadoru.dev/reference/mcp): The read-only MCP (Model Context Protocol) server exposed by tadoru mcp — tools, schemas, errors, and registration.
- [Event reference](https://tadoru.dev/reference/events): The event taxonomy, the JSON envelope shared by all events, and per-browser URL capture support.
- [Configuration](https://tadoru.dev/reference/config): The config.toml schema — capture sources, filters, output, and retention.

## 日本語

### Docs

- [Tadoru とは](https://tadoru.dev/ja): PC 操作履歴をローカルに記録し、LLM-ready なタイムラインとして AI agent に渡す OSS。
- [クイックスタート](https://tadoru.dev/ja/quickstart): インストールから最初のタイムライン取得、agent 連携まで。所要 5 分。
- [FAQ](https://tadoru.dev/ja/faq): プライバシー・ブラウザ対応・データアクセス・対応 OS・トラブルシューティングに関するよくある質問。

### ガイド

- [macOS 権限のセットアップ](https://tadoru.dev/ja/guides/permissions): Tadoru が使う TCC 権限の一覧と、tadoru doctor による診断・付与の流れ。
- [記録の開始と管理](https://tadoru.dev/ja/guides/recording): デーモンの起動・停止・一時停止・状態確認と、保存データのライフサイクル。
- [プライバシーモデル](https://tadoru.dev/ja/guides/privacy): 何が記録され、何が記録されないのか。Tadoru の「既定値のままで安全」を支える多層防御。
- [フィルタ](https://tadoru.dev/ja/guides/filters): ストアに書き込まれる前にイベントを破棄する許可/不許可リスト — Tadoru のプライバシー境界。
- [データの取り出し](https://tadoru.dev/ja/guides/timeline): 記録した行動を読み出す 3 つの方法 — timeline・query・export の使い分け。

### Agent 連携

- [Agent 連携](https://tadoru.dev/ja/agents): Tadoru が AI agent とつながる仕組み — 2 つの面と skill 指示レイヤー、対応 agent、agent にできること・できないこと。
- [セットアップ](https://tadoru.dev/ja/agents/setup): native 連携または手動配置用に表示される指示で、agent に Tadoru を設定する。

### リファレンス

- [CLI リファレンス](https://tadoru.dev/ja/reference/cli): tadoru の全コマンド・フラグ・共通規約・終了コード。
- [MCP サーバ](https://tadoru.dev/ja/reference/mcp): tadoru mcp が公開する read-only な MCP（Model Context Protocol）サーバ — ツール・スキーマ・エラー・登録方法。
- [イベントリファレンス](https://tadoru.dev/ja/reference/events): イベント型タクソノミー、全イベント共通の JSON エンベロープ、ブラウザ別の URL 捕捉対応。
- [設定](https://tadoru.dev/ja/reference/config): config.toml のスキーマ — 捕捉ソース・フィルタ・出力・保持期間。