設定

config.toml のスキーマ — 捕捉ソース・フィルタ・出力・保持期間。

設定は単一の TOML ファイルにまとまっています。

~/.config/zanei/config.toml

グローバルフラグ --config <path> で呼び出しごとに上書きできます。ヘルパーコマンドは次のとおりです。

zanei config init   # 設定パスに全項目のコメント付きテンプレートを生成
zanei config path   # 設定ファイルのパスを表示
zanei config show   # 有効設定（既定値マージ後）を表示
zanei config edit   # $EDITOR で開く
zanei config set capture.text_content true
zanei config set capture.content_snapshot true

zanei config init は不足している親ディレクトリを作成し、以下の完全なテンプレートを 書き込みます。既存ファイルは上書きせず、生成先が存在する場合はそのパスを表示して終了コード 1 で終了します。既定以外の場所を初期化するにはグローバル --config <path> を使います。

capture.text_content、capture.content_snapshot、output.batch_interval_s、output.retention_hours には zanei config setを使います。filter リストには zanei filter、その他の配列には config edit を使います。

全体例（既定値）

[capture]
sources = ["app", "window", "ui", "input", "browser"]
text_content = false            # 内容の捕捉は明示的な opt-in
content_snapshot = false        # 前面ウィンドウの Accessibility text を記録するか

[filter]                        # capture-time フィルタ = プライバシー境界（ストア書込前に適用）
exclude_apps = ["1Password", "Keychain Access"]   # 不許可リスト（bundle_id 推奨）。既定除外を同梱
include_only_apps = []          # 非空で許可リストモードに切替
exclude_websites = []           # browser URL event/本文。URL host のドット境界サフィックス一致
include_only_websites = []      # browser URL event/本文の許可リスト
redactors = ["credit_card", "token"]              # 限定的なパターンベースのスクラブ。email は opt-in

[filter.text_content]           # 入力・clipboard 本文だけ。event と内容以外の事実は残る
exclude_apps = ["com.apple.Safari", "org.mozilla.firefox", "com.brave.Browser",
                "com.microsoft.edgemac", "com.vivaldi.Vivaldi", "company.thebrowser.Browser"]
include_only_apps = []
exclude_websites = []
include_only_websites = []

[filter.content_snapshot]       # content.snapshot event だけ
exclude_apps = ["com.apple.Safari", "org.mozilla.firefox", "com.brave.Browser",
                "com.microsoft.edgemac", "com.vivaldi.Vivaldi", "company.thebrowser.Browser"]
include_only_apps = []
exclude_websites = []
include_only_websites = []

[output]
batch_interval_s = 5
retention_hours = 48            # 既定で短期保持

egress に相当する設定はありません。外部送信という機能自体が存在しないためです。

バリデーション

省略した設定に既定値を補完した後にバリデーションを実行します。受理するのは以下の 18 キーと任意の [filter.capture_policy] テーブル（それぞれ定義された section 内）だけで、それ以外のキーがあるとファイル全体を不正とします。config init は 18 項目をすべて出力し、[filter.capture_policy] は書き出しません。ルールに違反するファイルは受理されず、config show や config edit を含む設定を読み込むすべてのコマンドが exit code 1 で終了します。config set や filter に渡した不正値は使用法エラー（code 2）で、何も保存されません。config set が受け付けるのはスカラーキー（capture.text_content・capture.content_snapshot・output.batch_interval_s・output.retention_hours）のみで、配列キーは filter か手編集で変更します。

[capture]

[filter]

capture-time フィルタはストア書込前に適用されます。scope は 3 つです：全 event の [filter]、入力・clipboard 本文の [filter.text_content]、snapshot event の [filter.content_snapshot]。app / website の各軸では、include_only_* が非空なら only mode、空なら exclude mode です。exclude_* はどちらの mode でも常に優先します。

評価順は組み込み除外、[filter] の app と website、[filter.text_content]、[filter.content_snapshot] です。text-content scope 外では event と事実を残して本文 field を null にし、その window だけ capture.text_content = false と同じ形にします。snapshot scope 外では content.snapshot 自体を生成しません。サイトルールはChromeとSafariに適用します。詳細はフィルタガイドを参照し、list は zanei filter で管理してください。

nested scope も同じ 4 list 名を使います。既定値と挙動は上記のとおりです。デーモンは 3 scope すべてを約 2 秒間隔で監視しており、フィルタの変更はデーモン再起動なしで数秒以内に反映されます。

[filter.capture_policy]

recorder を組み込むアプリケーション向けの任意テーブルです。書き込むのはそのアプリケーションか 手編集で、config init は生成せず、config set と filter も触れません。このテーブルが無い設定は 上記のとおりに動作し、追加しても上記のキーの意味は変わりません。

記録対象アプリの選び方は全員共通です。 どのアプリケーションを記録するかは filter.exclude_apps と filter.include_only_apps、つまり zanei filter exclude-app と zanei filter only-app が管理する list が 決めます。capture_policy が足すのは、その list では表現できない browser の URL ルールと IDE の ファイルルールだけです。

allowed_apps は任意で、独自の許可リストを固定したい policy のためにあります。省略すればアプリ選択の ゲートは上記 2 つの filter list だけになり、指定すればそれらの後に追加で適用される許可リストになります （したがって allowed_apps = [] は何も記録しません）。

[filter] の app list を通過した event の評価順は次のとおりです。

1. 組み込み除外（パスワードマネージャ・資格情報ストア）が拒否します。どの設定でも解除できません。
2. allowed_apps がある場合、アプリの表示名が含まれていなければ拒否します（前後の whitespace を除いた 大文字小文字を無視した一致）。
3. Google Chrome と Safari は browser だけが決めます。
4. Cursor・Visual Studio Code・Code は ide が決めます。
5. それ以外のアプリは許可します。

browser が URL を許可した後も、[filter] と [filter.text_content] / [filter.content_snapshot] の website ルールは Chrome と Safari に適用されます。[filter] の他のキーと同様、変更は daemon の設定監視が 数秒以内に反映するため再起動は不要です。

利用者が特定アプリを除外でき、browser は 2 サイトに限定し、IDE の .env は決して捕捉しない組み込み アプリケーションが書く例です。

[filter]
exclude_apps = ["1Password", "Keychain Access", "com.tinyspeck.slackmacgap"]
include_only_apps = []

[filter.capture_policy]                 # allowed_apps なし: 上の exclude_apps がアプリのゲート

[filter.capture_policy.browser]
mode = "rules"
default_policy = "block"
on_url_unavailable = "block"
block_auth = true
block_payments = true
allow_list = [
  { host = "github.com", path_prefix = "", match_subdomains = false },
  { host = "example.com", path_prefix = "/docs", match_subdomains = true },
]
block_list = []

[filter.capture_policy.ide]
block_env_files = true
on_file_name_unavailable = "block"

同じ policy を only mode にした場合（利用者が記録する 2 アプリを選んだ状態）です。

[filter]
include_only_apps = ["com.apple.Notes", "com.google.Chrome"]

filter の list ではなく独自の許可リストを持たせる場合は次の形です。

[filter.capture_policy]
allowed_apps = ["Notes", "Google Chrome"]

[output]

zanei record は記録したイベントを NDJSON で出力します。daemon は単一のローカル SQLite ストアへ書き込みます。出力動作とストアバックエンドは設定できません。

変更の反映

• [filter]・[filter.text_content]・[filter.content_snapshot] の変更はデーモンの設定監視（約 2 秒間隔）で検知され、再起動なしで数秒以内に反映されます。
• output.retention_hours は daemon 再起動なしで反映され、新しい保持期間の外にある event を即時 purge します。それ以外（capture.sources・capture.content_snapshot・output.batch_interval_s 等）は zanei stop && zanei start でのデーモン再起動後に反映されます。

関連パス

イベントストアは暗号化されています。鍵は recorder の初回起動時に生成され、ログインキーチェーンに保存されます。暗号化に関する設定キーはありません。ZANEI_STORE_KEY_FILE=<path> を設定すると、すべての Zanei プロセスが代わりにそのファイルから鍵を読みます。これはソースからのビルド向けの開発用上書きで、CLI リファレンスに説明があります。