# Zanei

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

## Docs

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

## Guides

- [macOS permissions](https://zanei.dev/guides/permissions): The TCC permissions Zanei uses, and how zanei doctor diagnoses and guides you through granting them.
- [Recording](https://zanei.dev/guides/recording): Starting, stopping, and pausing the daemon, checking status, and the lifecycle of stored data.
- [Privacy model](https://zanei.dev/guides/privacy): What is recorded, what is not, and the layers that keep sensitive data out of the store.
- [Filters](https://zanei.dev/guides/filters): Allow and deny lists that decide which apps and sites are recorded, applied before events reach the store.
- [Retrieving data](https://zanei.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://zanei.dev/agents): How Zanei plugs into AI agents — the two surfaces, the skill instruction layer, which agents are covered, and what agents can (and cannot) do.
- [Setup](https://zanei.dev/agents/setup): Set up Zanei with native integration or printed instructions for manual placement.

## Reference

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

## 日本語

### Docs

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

### ガイド

- [macOS 権限のセットアップ](https://zanei.dev/ja/guides/permissions): Zanei が使う TCC 権限の一覧と、zanei doctor による診断・付与の流れ。
- [記録の開始と管理](https://zanei.dev/ja/guides/recording): デーモンの起動・停止・一時停止・状態確認と、保存データのライフサイクル。
- [プライバシーモデル](https://zanei.dev/ja/guides/privacy): 何が記録され、何が記録されないか。機微なデータをストアに入れないための各層。
- [フィルタ](https://zanei.dev/ja/guides/filters): どのアプリ・サイトを記録するかを決める許可/不許可リスト。ストアに書き込まれる前に適用されます。
- [データの取り出し](https://zanei.dev/ja/guides/timeline): 記録した行動を読み出す 3 つの方法 — timeline・query・export の使い分け。

### Agent 連携

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

### リファレンス

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