CLI リファレンス

tako CLI は、ターミナルの画面操作（ペイン分割・テキスト送信・レイアウト変更など）をコマンドとして実行するためのツールです。シェルスクリプトからの自動化にも、AI エージェントからの操作にも使われます。

トップレベルのコマンドは 86 種で、その多くがさらにサブコマンドを持ちます。ほぼすべてが同名の MCP ツールと 1:1 で対応しており（MCP ツール一覧）、人ができる操作は AI も同じ経路で実行できます。

共通の前提

tako の中のターミナルで実行するのが基本です。tako の外（通常のターミナル）で実行すると、接続情報が見つからない旨のエラーになります（tako setup / tako setup-mcp / tako platform / tako recover / tako migrate など一部はアプリ未起動でも動作します）
ペイン ID の自動特定: tako のペイン内から実行すると、環境変数 TAKO_PANE_ID から「自分がいるペイン」が自動で分かります。--pane を省略したときの対象は呼び出し元ペインです
ペイン ID の調べ方: tako list で全ペインの ID・タイトル・作業ディレクトリが JSON で確認できます
困ったら --help: すべてのコマンド・サブコマンドで使えます

tako --help
tako split --help
tako orchestrator spawn --help

コマンド早見表

やりたいことから引くための全 86 コマンドの一覧です。詳細のあるものはリンクから飛べます。

画面を操作する

コマンド	何をするか
`split`	隣に新しいペインを生やす
`send`	ペインへテキスト・コマンドを送る
`read`	ペインの画面内容を読む
`links`	画面のリンク（cmd+クリックで開けるもの）を列挙する
`list`	タブ・ペインの構成を JSON で得る
`focus`	フォーカスを移す
`scroll`	スクロールバックを動かす
`close`	ペインを閉じる
`title`	タイトル・役割ラベルを設定する
`resize`	ペインの取り分を変える
`equalize`	全ペインを均等化する
`tab`	タブの作成・切替・改名・ペイン移動
`window`	複数ウィンドウの操作
`menu`	メニューバーの構成取得・開閉・項目の実行
`collapse`	サイドバーのタブ枠を折りたたむ
`pin`	プレビューをフローティング化する

ファイルを見る・編集する

コマンド	何をするか
`open`	ファイルをプレビューペインで開く
`preview`	PDF・画像のズーム / ページ / パン
`preview-outline`	Markdown 見出し・PDF 目次へジャンプ
`preview-link-list`	PDF 内リンクの一覧
`preview-follow-link`	PDF 内リンクをたどる
`preview-copy-code`	Markdown コードブロック全文をコピーする
`preview-reload`	ライブリロードの ON/OFF
`preview-cache`	画像キャッシュ上限の確認・変更
`preview-changelog`	git 履歴ビューへの切替
`edit`	プレビュー上での軽量編集
`file`	パスコピー / Finder / リネーム / ゴミ箱
`tree`	ファイルツリーへフォルダを追加・削除
`video`	動画の再生・一時停止・シーク
`web`	Web ビューペインの操作
`run`	ファイルを実行する（Code Runner）
`run-default`	拡張子ごとの実行コマンド既定
`run-interactive`	入力が要るコマンドを可視ペインへ委譲
`run-interactive-status`	委譲したコマンドの完了確認

片付ける・保つ

コマンド	何をするか
`background`	ペインを退避する（プロセスは維持）
`foreground`	退避中ペインを戻す
`backgrounded`	退避中ペインの一覧
`tmux`	tmux セッションの一覧・kill・取り込み
`persist`	セッション永続化の ON/OFF
`recover`	レイアウトをバックアップ世代から復旧
`logs`	ペインの平文ログの参照・設定
`scrollback`	スクロールバック保持行数の確認・変更
`sessions`	会話セッションの発見と復元

git

コマンド	何をするか
`git log` / `diff` / `show`	履歴・差分・コミット詳細を JSON で得る
`git stage` / `unstage` / `commit`	ステージング・コミット
`git push` / `pull`	リモートとの同期
`git checkout` / `branch` / `merge`	切替・作成・マージ
`git conflicts` / `abort` / `resolve`	コンフリクトの確認・中止・AI 解消

AI と連携する

コマンド	何をするか
`master`	司令塔の AI を起動する
`solo`	1 対 1 の AI を起動する
`orchestrator`	worker の起動・監視・回収など
`task`	タスクチェックポイントと受け入れゲート
`todo`	ユーザー向けタスク（人がやること）の起票・一覧・返答
`mcp serve`	MCP stdio ブリッジ
`agents`	エージェント共通ルールの同期
`show-command`	コピー / 実行ボタンつきのコマンド提案カードを出す

表示と設定

コマンド	何をするか
`ui-mode`	かんたん表示（GUI モード）とターミナル表示の切替
`chat copy`	かんたん表示の会話本文をコピーする
`theme`	テーマ・色・フォント
`lang`	UI 表示言語（日本語 / 英語）
`settings`	設定画面を開く
`panel`	サイドバーの表示・幅・ビュー
`autosuggest`	入力予測（ゴーストテキスト）
`autorename`	タブ・ペインの AI 自動リネーム
`portdetect`	ポート検知と提案チップ
`confirm-close`	閉じる確認ダイアログ
`session-restart`	エージェントを会話ごと引き継いで再起動
`limit-resume`	利用上限後の自動復帰（ペイン単位）
`limit-service`	利用制限表示のサービス切替
`welcome`	初回起動バナーの状態・再表示

開く・戻る

コマンド	何をするか
`open-in`	ディレクトリ / リポジトリを新タブで、SSH をいまのタブの新ペインで開く
`recent`	最近開いた項目の一覧・クリア
`ssh-hosts`	`~/.ssh/config` の Host 一覧

リモート・セットアップ・診断

コマンド	何をするか
`remote`	スマホ等からの接続サーバー
`remote-folder`	SSH 先のフォルダをワークスペースとして開く
`setup`	質問ゼロの自動セットアップ
`setup-mcp`	MCP 登録だけ行う
`update`	アプリの更新確認・実行
`migrate`	設定・データファイルの形式確認と自動移行
`config`	AI 系設定のデバイス間共有（git ベース）
`platform`	この環境で使える機能の一覧
`check-health`	環境の健全性診断（CLI / MCP の受け口が立っているか）
`agent-support`	エージェント系統ごとの能力差
`shell-integration`	シェル統合（cwd 追従・コマンド状態）の確認・配置
`context-budget`	起動時ロードの予算の確認と作業ログの自動移送
`test-residue`	テスト・検証が残した一時 dir の掃除
`fda`	フルディスクアクセスの状態確認
`sleep-guard`	スリープ防止
`telemetry`	エラーレポート送信の ON/OFF
`stale-binary`	古い claude バイナリの検知・張り直し

セットアップ

tako setup

AI 連携に必要な設定を質問ゼロでまとめて行います。claude / codex / agy の認証・プランを検出し、前回値、安全な既定値の順で不足を補い、値の由来と最終サマリを表示します。CLI が 1 つ・認証済みの標準ケースは人間の入力なしで完走します。tako アプリが起動していなくても実行できます。詳しくはセットアップガイドを参照してください。

# 自動セットアップ（標準ケースは質問ゼロ）
tako setup

# 標準入力を一切読まずに自動セットアップ
tako setup --yes

# 全回答を JSON、ファイル、標準入力のいずれかで指定
tako setup --answers '{"selected_agent":"codex","provider_plans":{"gpt":"plus"}}'
tako setup --answers @setup-answers.json
generate-answers | tako setup --answers -

# 前回設定を AI と個別に見直す
tako setup --review

# 環境チェックだけ実行（CLI の有無・認証・プラン・MCP・セットアップ状態を表示）
tako setup --check

# アップデート追従状況を表示（前回セットアップ以降に setup へ入った変更の一覧）
tako setup --changes
tako setup --changes --json

# セットアップ状態をリセットして最初からやり直す
tako setup --reset

--answers は selected_agent、provider_plans、instruction_content、profile、projects、orchestrator、sleep_guard を受け取ります。同じ JSON は MCP tako_setup でも使えるため、AI に日本語で希望を伝えてセットアップを代行させられます。projects は指定時に全登録を置き換えます。

tako setup bootstrap

エージェント CLI（claude / codex / agy）がまだ入っていない環境で、導入から認証までを案内・実行します。tako setup が「1 つも使える系統が無い」ことを見つけたら自動でこの段を通るので、普段このコマンドを直接叩く必要はありません。AI から段ごとに操作したいときや、状態だけ確認したいときに使います。

tako setup bootstrap                          # 状態確認（既定。読み取り専用）
tako setup bootstrap status-all               # 3 系統ぶんをまとめて確認（読み取り専用）
tako setup bootstrap install --dry-run        # 何をどこに入れるかだけ表示
tako setup bootstrap install                  # 公式インストーラを実行
tako setup bootstrap install --agent codex    # 系統を選んで入れる
tako setup bootstrap path                     # claude をどのターミナルからも使えるようにする
tako setup bootstrap undo-path                # path で入れた設定を取り除く
tako setup bootstrap handoff                  # 別のエージェントへ導入を頼む

--agent を省略すると claude が対象です。claude / codex / agy から選べます（それ以外の名前は、間違って別の系統を入れないよう選択肢つきで拒否します）。

系統ごとの導入手順は次のとおりです（すべて公式のもの）。

系統	macOS の公式コマンド	コマンドの置き場所	以後の更新
`claude`	`curl -fsSL https://claude.ai/install.sh \| bash`	`~/.local/bin/claude`	Claude Code が自分でバックグラウンド更新
`codex`	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	`~/.local/bin/codex`	新しい版が出ると知らせるだけ（`codex update` で更新）
`agy`	`curl -fsSL https://antigravity.google/cli/install.sh \| bash`	`~/.local/bin/agy`	実行のたびに自分で背景更新

次の一歩（next_step）は 4 つのいずれかです。

値	意味
`install`	その CLI がまだ入っていない
`path`	入っているが、ターミナルからコマンドが呼べない
`auth`	入っているが、アカウントにログインしていない
`ready`	導入は済んでいる

ログインのコマンドは系統ごとに違います（claude auth login / codex login / 引数なしの agy）。どれもブラウザ操作が必要なので tako は代行せず、コマンドを案内するところまでです。

インストール前には必ず「実行するコマンド・取得元・置き場所・以後の更新」を表示します。管理者権限は使わず、ホームディレクトリの中だけで完結します。

「どのターミナルからも使えるようにする」のやり方は OS で違います。macOS / Linux はログインシェルの設定ファイル（zsh なら ~/.zprofile）へ 1 ブロック追記し、Windows はユーザー環境変数 Path へ追記します（Windows 版の公式インストーラは PATH を自動では通さず、手作業を案内して終わるためです）。どちらも undo-path で元に戻せます。macOS では 3 系統とも同じ場所（~/.local/bin）に入るので、追記されるブロックは 1 つだけです。

Windows で tako が実際にインストーラを走らせるのは claude だけです。codex / agy は状態の確認と公式コマンドの案内までで、実行は行いません（Windows 実機での確認が済んでいないためです）。表示される公式コマンドをご自身で実行すれば、そのあとの PATH 通しと状態確認は tako が引き継げます。詳しくは Windows 対応状況をご覧ください。

ネットワークやプロキシの都合でインストーラが動かないことがあります。そのとき入れようとしている系統以外がすでに入っていれば、tako setup はそのエージェントへ「これを入れて」と頼むことを提案します（tako setup bootstrap handoff でも同じことができます）。1 つも入っていなければ、自分で実行するコマンドを表示して終わります。

ログインだけはブラウザ操作が必要なので代行しません。その系統のログインコマンドの実行をお願いし、そこで tako setup はいったん終わります（ログインしたらもう一度 tako setup を実行してください）。tako がログインを起こさないのは、ブラウザの操作が終わるまで終わらないプロセスになるためです。誰も終わらせられないまま残り続けると CPU を食い続けます。

tako setup deps

tako が使う任意の外部ツール（ターミナルの永続化に使う tmux / psmux、git パネルの git、リモート接続の tailscale）の状態を確認し、その場で導入します。どれも無くても tako 自体は動きますが、欠けるとその機能が使えません。

tako setup deps                    # 状態確認（既定。読み取り専用）
tako setup deps install            # 未導入のものを導入
tako setup deps install --dep tmux # 1 つだけ導入
tako setup deps install --dry-run  # 何を入れるかだけ表示

導入済みのものには触りません（何度実行しても同じ結果になります）。導入を代行できるのは macOS の Homebrew（brew install）で、Windows は打つべき winget のコマンドを表示します。

標準の tako setup は質問をしないので、足りないツールがあっても状態と tako setup deps install の 1 行だけを表示します。1 つずつ「今すぐ入れますか？」と聞いてほしいときは tako setup --review を使ってください。

tako setup-mcp

エージェント CLI に tako の MCP サーバーを登録します。対話なしで登録だけしたいときに使います。

tako setup-mcp                   # claude + 導入済みの codex / agy へまとめて登録（既定）
tako setup-mcp --agent codex     # codex だけに登録
tako setup-mcp --project         # 現在のディレクトリだけに登録（claude のみ）

引数なしのときは claude と、この環境に導入済みの codex / agy をまとめて対象にします。未導入の CLI は理由つきで skip するだけでエラーになりません。--agent で明示指定したときだけ、その CLI が未導入なら分類済みエラー（理由 + 次の一手）で止まります。

エージェント	書き込み先	手段
claude	`~/.claude.json`（`--project` 時は `<cwd>/.mcp.json`）	`claude mcp add`（無ければ JSON を直接マージ）
codex	`~/.codex/config.toml` の `[mcp_servers.tako]`	`codex mcp add` + `env_vars` の追記
agy	`~/.gemini/config/mcp_config.json` の `mcpServers.tako`	`agy mcp add`

codex / agy は各 CLI の mcp add に書き込みを任せています。自分で TOML / JSON を書くと CLI 側の正規化と二重にずれるため、利用者が手で codex mcp add を打ったのと同じ結果になる経路へ寄せてあります。何度実行しても設定は同じ内容に収束します（--project は codex / agy が対応していないので、明示指定すると理由を出して止まります）。

tako の MCP サーバーは、tako の中から起動されたことを環境変数（TAKO_SOCKET / TAKO_TOKEN）で確認してからツールを公開します。agy は MCP サーバーへ環境変数をそのまま渡すので登録だけで足りますが、codex は既定で 1 つも渡しません。そのため codex の登録には転送する変数名の一覧（env_vars）も一緒に書き込みます。変数名だけを書くので、トークンが設定ファイルに残ることはありません。

codex mcp add はこの一覧を上書きで消してしまうため、tako setup-mcp は登録のあとに書き足し、codex mcp list で反映を確認します。確認できなければ理由つきのエラーになります。

tako update

アプリのアップデートを確認・実行します。Homebrew / ZIP のどちらでインストールしたかを自動判別します。更新チェックは「自分の OS 向けのアセットを含む最新リリース」を探すため、他 OS 版だけが先に出ている状況で「更新はあるが入れられない」通知が出ることはありません。

tako update status      # 配布系統・現在バージョン・PATH 上の重複 CLI を診断
tako update check       # 新しいバージョンがあるか確認（更新はしない）
tako update apply       # 更新を実行（レイアウト保存 → 更新 → 自動再起動）

# brew での更新が失敗して詰まったときの復旧
tako update repair      # Homebrew の管理情報を修復
tako update apply-zip   # zip 経由で強制更新

基本操作

tako split

ペインを分割して新しいペインを作ります。新しいペインの ID が出力されるので、続けて send や read の対象にできます。

tako split --right                              # 右に分割（既定）
tako split --down                               # 下に分割
tako split --right -- npm run dev               # 分割してコマンドを実行
tako split --right --ratio 0.3 -- htop          # 新ペインの取り分を 30% に
tako split --down --cwd ~/Documents/webapp --focus

オプション	説明
`--right` / `--down` / `--up` / `--left`	分割方向（省略時は右）
`--ratio <0.0–1.0>`	新ペイン側の取り分（省略時は等分）
`--cwd <パス>`	新ペインの作業ディレクトリ
`--focus`	新ペインにフォーカスを移す
`--pane <ID>` / `--tab <ID>`	分割元の指定（省略時は呼び出し元ペイン）
`-- <コマンド>`	シェルの代わりに実行するコマンド

-- <コマンド> で実行するコマンドは、普通にペインを開いたときと同じ環境（ログインシェル + ~/.zshrc などの設定ファイルを読んだ後の PATH）で動きます。nodebrew / fnm / Homebrew で入れた npm や node も、ターミナルで打つときとまったく同じように見つかります。

コマンドが失敗したときだけ、ペインは閉じずに終了コード（__TAKO_EXIT=<コード>）と案内を残して止まります。Enter を押すとペインが閉じます。成功したコマンドは今までどおり終わった時点でペインごと閉じるので、そのときの出力は tako logs show <ペイン ID> で後から読めます。

tako send

ペインにテキストを送信します。既定で末尾に改行（Enter）が付くので、コマンドはそのまま実行されます。

tako send --pane 3 "echo hello"
tako send --pane 3 --no-newline "yes"
tako send --pane 3 --await-prompt "テストを実行して結果を教えて"

オプション	説明
`--pane <ID>`	送信先ペイン（省略時は呼び出し元）
`--no-newline`	末尾に改行を付けない
`--await-prompt`	入力欄が表示されるのを待ってから送信

tako read

ペインの画面内容をテキストとして取得します。

tako read --pane 3
tako read --pane 3 --lines 50

tako links

画面の中で cmd+クリックで開けるもの（URL・実在するパス）を列挙します。GUI のクリック判定と同じ経路を通るので、「この画面のこのパスはリンクになるのか」を人手のクリック無しに確かめられます。--text を渡すと画面の代わりにその文字列を材料にするため、画面の写しを貼って判定を再現できます。

tako links                           # 呼び出し元ペインの画面
tako links --pane 3
tako links --text "$(cat out.txt)"   # 画面の写しで判定を再現する

tako list

タブ・ペインの構成を JSON で出力します。各ペインの ID・タイトル・作業ディレクトリ（cwd）・実行状態・listen 中のポートなどが含まれます。ペイン ID を調べる出発点です。

tako list

tako focus

指定ペインにフォーカス（入力先）を移します。

tako focus 3        # ID 指定
tako focus --right  # 方向指定

tako scroll

ペインのスクロール位置を動かします。

tako scroll --pane 3 --delta 100  # 100 行分過去へ
tako scroll --pane 3 --to 0       # 最下部（最新）に戻る

tako close

ペインを閉じます（中のプロセスも終了します）。タブ最後の 1 ペインを閉じるとタブごと閉じます。

tako close --pane 3
tako close --pane 3 --force   # 実行中の worker でも強制的に閉じる

tako title

ペインの表示タイトルと役割ラベルを設定します。

tako title --pane 3 "dev server"
tako title --pane 3 --role worker-1 "修復係"
tako title --pane 3 ""   # 空文字でクリア（自動リネームに戻る）

レイアウト操作

tako resize

ペインの取り分（画面に占める割合）を調整します。

tako resize --pane 3 --dx 0.1       # 横方向に 10% 広げる
tako resize --pane 3 --dy -0.1      # 縦方向に 10% 縮める
tako resize --pane 3 --share-x 0.6  # 横の取り分を 60% ぴったりに

オプション	説明
`--dx` / `--dy`	相対変更（正 = 広げる、負 = 縮める）
`--share-x` / `--share-y`	絶対指定（0.0〜1.0）

tako equalize

タブ内の全ペインを均等サイズに整えます。

tako equalize
tako equalize --tab 2

tako tab

tako tab new                              # 新しいタブを作成
tako tab new --title "API Server"
tako tab rename --tab 2 "フロントエンド"    # タブ名を変更
tako tab rename ""                        # 手動指定を解除（自動リネームに戻る）
tako tab select 2                         # タブを切り替え
tako tab move-pane 2 --pane 5             # ペインを別タブの末尾へ移動
tako tab move-pane --pane 5 --target 3 --down  # 同タブ内で並べ替え

tako window

複数ウィンドウを扱います。タブバーは全ウィンドウ共通で全タブを表示し、タブをクリックするとそのウィンドウに表示が移ります（1 つのタブが同時に 2 つのウィンドウに出ることはありません）。

tako window list                          # ウィンドウ一覧
tako window new                           # 新規タブ付きで新しいウィンドウ
tako window new --tab 3                   # 既存タブ 3 を分離して新ウィンドウへ
tako window move-tab --tab 3 --window 2   # タブを別ウィンドウへ移動
tako window focus 2                       # ウィンドウを前面化
tako window close 2                       # 閉じる（タブは残存ウィンドウへ合流）
tako window move 300 200                  # 窓を動かす（ディスプレイ内の座標）
tako window resize 1600 1000              # 窓の寸法を変える（位置は動かない）

move / resize の座標はそのディスプレイの左上を原点とする位置です（--window W を省略するとアクティブウィンドウが対象）。現在の矩形は tako window list の bounds、置き先のディスプレイは同じ応答の display で読めます。最小寸法（200x150）未満や画面からはみ出す指定は理由つきで断ります。

起動時から位置を決めたいときは環境変数 TAKO_WINDOW_BOUNDS を使います。

TAKO_WINDOW_BOUNDS=100,50,1400,900 tako   # 位置と寸法
TAKO_WINDOW_BOUNDS=1400,900 tako          # 寸法だけ（画面の中央へ）

メニューバーの構成取得・開閉・項目の実行を行います。開閉は Windows 限定です（macOS のメニューは OS 側のメニューバーに載るため、tako から開閉できません）。項目の実行はどちらの OS でも使えます。

tako menu list                       # メニュー構成と開閉状態（項目名とショートカット付き）
tako menu invoke ファイル/新規タブ   # 項目を実行する
tako menu open 表示                  # メニューを開く（Windows のみ）
tako menu close                      # 閉じる（Windows のみ）

タブ枠の折りたたみ

サイドバーのタブ枠を折りたたみ / 展開します（配下のバックグラウンド行を隠します）。

tako collapse --tab 2 on    # 折りたたむ
tako collapse --tab 2 off   # 展開
tako collapse --tab 2       # トグル

ファイル・プレビュー

tako open

ファイルをプレビューペインで開きます。コードはシンタックスハイライト付き（210 以上の形式）、.md はレンダリング表示、画像・PDF・動画にも対応します。

tako open src/main.rs
tako open README.md --mode code     # Markdown をソース表示で
tako open src/app.tsx --right       # 右に分割して開く

オプション	説明
`--mode <code\|markdown\|image\|pdf\|video>`	表示モードの明示指定
`--right` / `--down` / `--up` / `--left`	分割して新しいプレビューペインで開く
`--pane <ID>`	基準ペイン（相対パスの解決と表示先に使う）

プレビューの操作

開いているプレビューを外から操作します。

# PDF・画像のズーム / ページ / パン（引数なしで現在状態）
tako preview

# Markdown 見出し・PDF 目次のアウトライン（1 始まりの項目番号でジャンプ）
tako preview-outline
tako preview-outline --item 4

# Markdown / PDF のリンク（開くのは http / https のみ）
tako preview-link-list
tako preview-follow-link

# Markdown のコードブロックを装飾なしでコピー（出現順 0 始まり・省略で先頭）
tako preview-copy-code
tako preview-copy-code 2

# ファイルが書き換わったら自動で反映（既定 ON）
tako preview-reload          # 現在値
tako preview-reload off

# デコード済み画像キャッシュの上限（既定 512 MiB、256〜8192）
tako preview-cache           # 上限・使用量・件数
tako preview-cache 1024

# コード表示 ⇔ git 履歴（チェンジログ）表示の切替
tako preview-changelog

tako edit

コードプレビュー上での軽量編集です。開始 → 全文適用 → 保存の 3 段階で、外部から書き換えられていた場合は保存を拒否します。

tako edit --help    # 開始 / 全文適用 / 保存のサブコマンドを確認

tako file

ファイルツリーの右クリックメニューに相当する操作群です。

tako file copy-path src/main.rs        # 絶対パスを出力（--relative で相対）
tako file reveal src/main.rs           # Finder で表示
tako file open-terminal ~/Documents/webapp  # ペイン内で cd
tako file rename old.txt new.txt
tako file create src helper.ts         # path 配下に name で作成
tako file mkdir src components
tako file trash old-notes.md           # ゴミ箱へ移動

tako tree

ファイルツリーに表示するフォルダを明示的に追加・削除します。AI が作業対象プロジェクトを提示するのに使います。

tako tree add ~/Documents/webapp
tako tree remove ~/Documents/webapp
tako tree list

git-status で、ファイルツリーに色とバッジで出ている git の状態をそのまま取得できます（画面と同じ分類）。

tako tree git-status                     # タブのワークスペースフォルダ全部
tako tree git-status ~/Documents/webapp  # フォルダを 1 つに絞る
tako tree git-status --limit 50

応答の entries[] は 1 行ぶんの状態です。

state — modified / added / deleted / renamed / untracked / conflicted / ignored
staged / unstaged — git の XY（git status --short と同じ記号）。ステージ済みと未ステージを分けて持ちます
propagated — true ならディレクトリ行で、changed が配下の変更ファイル数です

tako video

プレビューペインで動画を開いているときの再生操作です。

tako video play --pane 4
tako video pause --pane 4
tako video toggle --pane 4
tako video seek 90 --pane 4   # 90 秒地点へ

tako web

URL をネイティブ Web ビューペイン（macOS = WKWebView）として開きます。ペイン内ではクリック・スクロール・文字入力を普通のブラウザ同様に行えます。hide でページを生かしたまま dock へ退避し、show で呼び戻せます。

tako web open http://localhost:5173 --right
tako web list                                # 一覧
tako web hide                                # dock へ退避（ページは生きたまま）
tako web show 3
tako web nav back                            # 戻る（forward / reload / URL も可）
tako web eval 'document.title'               # JS 評価
tako web eval-result <token>                 # 評価結果の回収
tako web read                                # URL・タイトル・読み込み状態
tako web close

tako run / run-default

Code Runner。ファイル内の tako:run 宣言、または拡張子ごとの既定コマンドで、新しいペインを分割して実行します。プレビューヘッダの再生ボタンと同じ経路です。

tako run script.py                 # 実行（新ペインを分割）
tako run script.py --profile test  # プロファイルを指定
tako run script.py --list          # 使えるプロファイルの一覧
tako run script.py --wait          # 完了まで待って終了コードを返す

tako run-default                   # 拡張子ごとの既定コマンド一覧
tako run-default py "python3"      # 既定を設定
tako run-default py --remove       # 既定を削除

tako run-interactive

ユーザーの入力が必要なコマンド（パスワードや対話ログインを伴うものなど）を、見えるペインへ委譲します。分割 → タイトル設定 → コマンド投入をまとめて行い、ペイン ID を返します。AI が「自分では答えられない対話」を人間に渡すための経路です。

tako run-interactive --help
tako run-interactive-status --help

バックグラウンド退避（たまり場）

tako background / foreground / backgrounded

「処理は動かしたまま、画面からだけ消す」操作です。詳しくはたまり場を参照してください。

tako background --pane 3       # 退避（プロセスは生きたまま）
tako backgrounded              # 退避中ペインの一覧（JSON）
tako foreground 3              # 画面へ復帰（省略時は元いたタブへ）
tako foreground 3 --target 5 --direction down

git

作業ディレクトリの git リポジトリを操作します。GUI の git パネルと同じ経路です。詳しくは git 連携を参照してください。

情報を読む

tako git log                       # 履歴・ブランチ・変更状態（--max-count、既定 200）
tako git diff                      # 差分（既定は未ステージ）
tako git diff --target staged
tako git diff --target a1b2c3d
tako git show a1b2c3d              # コミット詳細（メタ情報 + 変更ファイル一覧）
tako git show a1b2c3d --file src/main.rs   # そのファイルの diff も含める

変更を記録する

tako git stage src/main.rs         # パス省略で全変更をステージ
tako git unstage src/main.rs       # パス省略で全アンステージ
tako git commit -m "[修正] ログイン失敗を直す"
tako git push
tako git pull

ブランチを操作する

破壊的になりうる操作は、既定では実行しません。「何が起きるか」を先に出し、--yes を付けたときだけ実行します。

# 切替: 未コミット変更があると、持ち越すもの / 衝突するものを出して止まる
tako git checkout main
tako git checkout main --yes

# 作成して切り替え
tako git branch fix/login
tako git branch fix/login --from main --no-checkout

# マージ: 作業ツリーに触れずにコンフリクトを事前予測して出す
tako git merge feature/x
tako git merge feature/x --yes --no-ff

コンフリクトを解く

tako git conflicts                 # 未解決ファイル・進行中の操作を JSON で
tako git abort                     # merge / rebase / cherry-pick / revert を中止
tako git resolve                   # 解消エージェントを同じタブに起動
tako git resolve --agent codex

tako git resolve は、リポジトリ・未解決ファイル・マージ元 / 先を含む解消プロンプトを自動で投入します。文面は <データディレクトリ>/orchestrator/conflict-resolver.md を置けば差し替えられます。

tmux 管理

tako は tmux セッションの「見える化と片付け」もできます。詳しくは tmux バックエンドを参照してください。

tako tmux list                     # 全セッション一覧（tako のペインとの対応付き）
tako tmux cleanup                  # 取り残されたセッションの一括掃除
tako tmux kill --session my-session
tako tmux kill --session my-session --window 1
tako tmux open my-session --right  # 外部セッションを現在のタブへ取り込む
tako tmux select-window 1 --pane 3
tako tmux resize --session my-session --cols 80 --rows 24
tako tmux resize --session my-session --reset

tako scrollback

ペインが遡れる行数（スクロールバック保持上限）です。既定は 10,000 行で、範囲は 100〜100,000。

tako scrollback         # 現在値・既定・下限・上限・適用中のペイン数・飽和時の見積り
tako scrollback 2000    # 2,000 行に下げる

履歴が飽和したペインは 行数 × 桁数 × 24 バイト を保持します（119 桁 10,000 行で約 29 MB / ペイン）。下げるとその場で既存ペインの履歴も切り詰められるので、メモリはすぐ戻ります。

tako recover

タブ・ペインが大量に消えてしまったときの復旧です。tako を終了してから 適用します。

tako recover                   # layout.json とバックアップ世代の一覧
# ここで tako を終了する
tako recover --apply 1         # 世代 1〜3 を指定して復元
tako recover --apply good      # 最後に復元へ成功した「良品」へ戻す
# tako を再起動する

tako migrate

設定・データファイルの形式を確認します。普段は呼ぶ必要がありません: 形式が変わったときは tako setup の実行時と、GUI / master / CLI の起動時に自動で移行されます（tako は手動の移行作業を要求しません）。

tako migrate                       # 全永続ファイルの形式を確認するだけ（何も書き換えない）
tako migrate run                   # 旧形式があればその場で移行する（冪等）
tako migrate run --schema profiles # 種別を 1 つに絞る

旧内容は <ファイル名>.pre-v<版数>.bak、解釈できなかった内容は <ファイル名>.unreadable.bak へ退避されるので消えません。応答の files[].state が unreadable のものは「設定が壊れているので既定値で動いている」という意味です。

設定が壊れて GUI が起動しないときの復旧手段なので、tako recover と同じくアプリが動いていなくても実行できます。

tako logs / sessions

ペインが死んだ後でも出力を遡ったり、過去の会話を呼び戻したりできます。

tako logs list                          # ログファイル一覧
tako logs show 3 --lines 500            # 末尾を表示（クローズ済みペインも可）
tako logs status                        # ON/OFF・上限・保存先
tako logs set --enabled true --max-mb 5 --total-max-mb 200

tako sessions list                      # 会話カタログ（新しい順）
tako sessions list --role worker
tako sessions show <session-id>         # メタ情報と会話冒頭
tako sessions resume <session-id>       # 記録された cwd で復元（claude のみ）

表示・設定のトグル

# 右サイドバーの情報パネル（--view の値は GUI のタブ表示名と同じ）
tako panel --show --view fleet   # fleet = 全ペイン + tmux セッション
tako panel --view orch           # orch  = master + ワーカーツリー
tako panel --view git            # git   = ブランチ・変更・履歴・diff
tako panel --view tasks          # tasks = 人がやること（承認・レビュー・投稿）
tako panel --hide
tako panel --filetree on         # 左のファイルツリー
tako panel --width 360
tako panel --show-hidden on      # ツリーにドット項目も並べる（既定 off）

# プレビューのピン留め（フローティングウィンドウ化）
tako pin --pane 3 on
tako pin --pane 3 off

# セッション永続化（tmux バックエンド）
tako persist                     # 現在状態
tako persist on
tako persist off

# ポート検知（「プレビューを開く？」チップ）
tako portdetect on
tako portdetect off

# タブ・ペイン名の AI 自動リネーム
tako autorename on
tako autorename off

# 閉じる確認ダイアログ（エージェント・実行中プロセスのあるペインのみ確認）
tako confirm-close on
tako confirm-close off

# ステータスバーの利用制限表示をどのサービスにするか
tako limit-service               # 現在値
tako limit-service codex

tako ui-mode

かんたん表示（GUI モード）とターミナル表示を切り替えます。既定は terminal（従来どおりの表示）です。詳しくはかんたん表示（GUI モード）を参照してください。

tako ui-mode                     # 現在のモードと、各ペインに出ている表示種別
tako ui-mode gui                 # かんたん表示へ
tako ui-mode terminal            # ターミナル表示へ
tako ui-mode toggle

tako ui-mode release --pane 3    # そのペインだけターミナル表示に戻す（揮発）
tako ui-mode restore --pane 3    # 戻した指定を解除する

応答の pane_display が、いま各ペインに出ているもの（terminal / starter / chat / preparing）を返します。AI はこれを見てから案内できます。

tako chat copy

かんたん表示の会話本文をクリップボードへコピーします。UI のコピーボタンと同じ経路です。

tako chat copy                       # 最後の AI 発話（画面と同じプレーンテキスト）
tako chat copy --list                # 添字・role・文字数・コードブロック数の下見
tako chat copy --message 3           # 添字 3 の発話（0 始まり）
tako chat copy --message 3 --code 0  # その発話の 1 つ目のコードブロックだけ（0 始まり）
tako chat copy --markdown            # Markdown ソースのまま

tako show-command

ターミナル領域を縮めて作った専用の帯に、コピー・実行ボタンつきのコマンドカードを出します。AI が会話本文に書いたコマンドは折り返しでコピーが壊れるため、実行を頼むコマンドはこれで提示します（カードは永続化されません）。

tako show-command "cargo test --workspace" --label "テストを流す"
tako show-command --list          # 出ているカードの一覧
tako show-command --copy --index 1   # コマンド番号は 1 始まり
tako show-command --run --index 1    # 新しいペインで実行する（既定はフォーカスを移さない）
tako show-command --dismiss

tako theme

tako theme                       # 現在のテーマを表示
tako theme dark
tako theme light
tako theme toggle
tako theme colors                # 色キーの一覧と現在値
tako theme preset save mytheme   # 現在の配色をプリセットとして保存

tako theme --help に色キー・プリセット・フォント指定の全オプションが出ます。

tako lang

tako lang            # 現在の表示言語
tako lang en         # 英語
tako lang ja         # 日本語
tako lang system     # OS のロケールに追従

tako settings

設定画面（独立ウィンドウ）を開きます。Cmd+, と同じです。一般・外観・Code Runner・プロファイル・セットアップ・スリープ防止・リモート・高度の 8 タブがあります。

tako settings
tako settings --tab appearance

--tab は英語スラッグ（general / appearance / runner / profiles / setup / sleep / remote / advanced）だけを受け付けます。日本語のタブ名を渡すと一般タブが開きます。

tako autosuggest

tako 内の zsh に出る入力予測（履歴ベースのゴーストテキスト）です。既定は ON。tako が開いたシェルの中だけで効き、~/.zshrc は書き換えません。確定は → または Tab です。

tako autosuggest             # 現在状態
tako autosuggest off         # 予測そのものを止める
tako autosuggest on

tako autosuggest tab off     # Tab での確定だけ無効化（→ キーは残る。既定 ON）
tako autosuggest hint off    # 確定キーの案内を今すぐ止める（既定は 10 回で自動終了）

tako session-restart

エージェントのペインを会話を失わずに建て直します。ペインを右クリックしても同じ 2 つを選べます。引数なしで実行すると「いま何ができるか」だけを返し、何も起こしません。

tako session-restart                       # 下見（できること + できない理由）
tako session-restart --mode harness        # 会話を保ったまま CLI を建て直す
tako session-restart --mode handoff        # 引き継ぎを書かせて交代（master のみ）
tako session-restart --mode harness --pane 12   # 別のペインを指定

--mode harness はエージェント CLI のプロセスだけを終わらせ、落ちたことを確かめてから claude --resume <会話 ID> を投入します。会話はそのまま続き、アカウント・モデル・思考の深さも元のまま戻ります。claude を自動更新したのに古い版のまま動いているペイン（ヘッダに「claude X が利用可能です」が出ているもの）を、会話を捨てずに新しい版へ載せ替えるための操作です。

--mode handoff は master ペイン専用で、引き継ぎファイルを書き直してから後任へ交代させます（コンテキストの使用率が高くなったときに tako が自動でやることを、任意のタイミングで起こせるようにしたものです）。

tako limit-resume

利用上限（5 時間制限・週次制限）でエージェントが止まったとき、リセット時刻を過ぎたら tako が作業を再開させます。ペイン単位のオプトインで、既定は OFF。ペインを右クリックしても同じ設定を切り替えられます。

tako limit-resume             # 今のペインの状態
tako limit-resume on          # 有効にする
tako limit-resume off

tako limit-resume on --pane 12  # 別のペインを指定
tako limit-resume --all         # 全ペインの状態を一覧

発動するのは上限で止まったときだけです。上限の対処ダイアログが出ていれば「解除まで待つ」相当の選択肢をラベルで選び（Upgrade … や Continue with usage credits のような課金・モデル変更を伴う選択肢は選びません）、ダイアログが無ければ継続を促すメッセージを送ります。

tako welcome

初回起動時にタブバー直下へ出る案内バナーの操作です。

tako welcome           # 表示状態と案内すべきコマンド
tako welcome show      # もう一度出す
tako welcome dismiss   # 消す

開く・戻る

tako open-in / recent / ssh-hosts

tako open-in dir ~/Documents/webapp   # 新タブで開く（ファイルツリーにも追加）
tako open-in repo ~/Documents/webapp  # git root を自動検出して開く
tako open-in remote myserver          # SSH 接続（いまのタブに新ペイン）

tako recent                           # 最近開いた項目
tako ssh-hosts                        # ~/.ssh/config の Host 一覧

一覧は Include の取り込み先（Include config.d/* のような相対パスは ~/.ssh/ 起点・glob 対応）まで辿るので、ssh で繋げるホストが一覧から漏れません。Host web1 web2 のように 1 行へ複数書いた場合は両方が別のエントリとして並びます。Match ブロックの中の設定（Match host bastion 配下の User / Port など）は、その直前の Host には付きません（ssh 自身と同じ扱い）。ワイルドカード（* / ?）や否定（!host）のパターンは繋ぎ先が決まらないので一覧に出ません。

SSH の開き先は --target で選べます（省略時 split）。

tako open-in remote myserver                  # いまのタブに新ペイン（既定）
tako open-in remote myserver --target tab     # 新しいタブ
tako open-in remote myserver --target pane    # いまのペイン自体を SSH にする
tako open-in remote myserver --target pane --pane 3   # ペイン 3 を SSH にする
tako open-in remote myserver --remote-dir /srv/app    # 接続後にそのフォルダへ cd

--target pane は ペインを増やさずそのペイン自体を SSH セッションにします（ペイン ID は変わりません）。素のシェルのペインだけが対象で、全画面 TUI が動いている・コマンド実行中・ AI エージェントのペイン・プレビューは理由と次の一手つきで断られます。接続に失敗してもそのペインのシェルのプロンプトへ戻るので、やり直しはその場でできます。

GUI では **ペインの右クリック →「このペインでリモート接続…」**が同じ操作です（ファイルメニューの「リモート接続…」は新しいペインを作る側）。

リモートアクセス

スマホなど外部デバイスから tako の画面を見る・操作するための機能です。仕組みと安全性の詳細はリモートアクセスを参照してください。

transport は Tailscale Serve のみです。あなたの tailnet 内限定の恒久固定 URL https://<ホスト名>.<tailnet>.ts.net で公開され、通信は WireGuard でエンドツーエンド暗号化されます。URL は public internet には存在しません。

# 初回だけ: 対話ウィザード（Tailscale 導入 → ログイン → HTTPS → serve 設定 → QR 生成）
tako remote setup
tako remote setup --yes

# 起動・停止・状態
tako remote start
tako remote status      # 恒久固定 URL・登録端末数（secret は含まれない）
tako remote stop

# ペアリング済み端末の一覧・失効（失効すると接続中の端末は即座に切断）
tako remote devices list
tako remote devices revoke <device-id>

# 中身を覗く
tako remote agents                          # 動作中の AI エージェント一覧
tako remote messages <session-id> --tail 30 # 会話ログ末尾
tako remote scrollback <pane-id> --lines 1000

SSH 先のフォルダをワークスペースとして開くのは別コマンド（tako remote-folder）です。ファイルツリーにリモートのディレクトリが並び、ファイルはプレビューで開いて編集・保存できます。認証は ~/.ssh/config・鍵・ControlMaster をそのまま使うので追加設定は要りません。

tako remote-folder open myhost               # リモートのホームをツリーへ（SSH 済みのターミナルも用意される）
tako remote-folder open myhost /srv/app      # パス指定
tako remote-folder open myhost --no-terminal # ツリーへ開くだけ
tako remote-folder list                      # 開いているリモートフォルダ
tako remote-folder ls myhost /srv            # ツリーを開かずに覗く
tako remote-folder close myhost              # 閉じる（省略で全ホスト）

Tailscale が未セットアップの場合、tako remote start は不足項目を列挙して tako remote setup を案内します。ステータスバーのリモートチップからも同じ起動ができます。

オーケストレーター

複数の AI エージェントを親子で連携させる機能です。考え方はオーケストレーションとは、使い方は tako master 実践ガイドを参照してください。

このうち、日常であなたが打つのは tako master（または tako solo）だけです。それ以外の tako orchestrator 系コマンドは、通常は master（AI）自身が内部で実行するもので、手動操作やスクリプトからの自動化用に公開されています。

tako master

司令塔となる AI を起動します。以後はこの master に自然言語で作業を依頼するだけで、子 worker の起動・監視・検収・回収が自動で回ります。

既定では今いるペインでそのまま起動します（新しいタブは作りません）。

tako master              # default プロファイル、今のペインで
tako master --tab        # 新しいタブを作って起動
tako master -fast        # プロファイル指定（profiles/fast.yaml）
tako master dev          # 旧形式のサフィックス指定（"master-dev" タブ）

tako solo

worker を使わず、AI と 1 対 1 で作業するモードです。worker の spawn をあえて禁止し、その AI 自身が手を動かします。既定の思考量は high で、Pro プランでも運用しやすい設計です。master と同じプロファイル引数が使えます。

tako solo
tako solo --tab
tako solo -fast

tako orchestrator projects

master が作業対象にできるプロジェクトの登録・管理です。通常は master に「◯◯のリポジトリを追加して」と頼むだけで済みます。登録内容は ~/Library/Application Support/tako/orchestrator/projects.yaml に保存されます。

tako orchestrator projects list
tako orchestrator projects add --key webapp --cwd ~/Documents/webapp --description "Web アプリ"
tako orchestrator projects remove --key webapp

add はそのプロジェクト専用のプロファイル（profiles/webapp.yaml）も同時に作ります。中身は default を引き継ぎ、管轄（projects）と起動フォルダ（cwd）だけがそのプロジェクトのものになります。既にあるプロファイルには触りません。登録済みのプロジェクトは tako setup や次回のアプリ起動でまとめて揃います。

tako orchestrator adopt

素の tako master で始めた会話を、その場でプロジェクト専用 master に切り替えます。 セッションは立て直さないので、会話もコンテキストもそのまま残ります（トークンを使い直しません）。

master は対象プロジェクトを見つけた時点でこれを自分で呼ぶので、通常ユーザーが打つことはありません。

tako orchestrator adopt webapp        # プロファイル名 / プロジェクトキーのどちらでもよい
tako orchestrator adopt default       # 汎用（どのプロジェクトにも属さない状態）へ戻す

切り替わるのは tako 側の状態です。

切り替わるもの	中身
ペインの役割ラベル	`orchestrator-master:<key>` になり、画面でも見分けがつく
`tako orchestrator self`	`profile` / 引き継ぎファイルの宛先 / 管轄プロジェクトがそのプロファイルの値になる
worker の既定	以後 spawn する worker がそのプロファイルのモデル・思考量・エージェントで立つ
引き継ぎ	`tako orchestrator handoff` と自動ハンドオフが `tako master -<key>` で後任を立てる

プロファイルがまだ無いプロジェクトキーを渡すと、その場で default から引き継いで作ります（tako orchestrator projects add の時点でも作られます）。

tako orchestrator profiles

master・worker が使うモデルや思考量（effort）の設定です。

tako orchestrator profiles list
tako orchestrator profiles show
tako orchestrator profiles set default --model claude-opus-4-6 --effort max
tako orchestrator profiles set default --clear-model   # claude 既定モデルに戻す
tako orchestrator profiles set sol --master-agent codex --model gpt-5.6-sol --effort xhigh
tako orchestrator profiles set default --ctx-threshold 55   # 自動ハンドオフの閾値（50〜60）
tako orchestrator profiles set takodev --cwd ~/dev/tako      # master をこのフォルダで起動する

`set` の主なオプション	説明
`--master-agent` / `--clear-master-agent`	master のエージェント CLI（claude / codex。agy は master 非対応）
`--model` / `--clear-model`	master のモデル指定 / 解除
`--effort`	master の思考量
`--worker-model` / `--clear-worker-model`	子 worker 用の固定モデル / 解除
`--worker-effort`	子 worker の思考量
`--worker-agent` / `--clear-worker-agent`	worker の既定エージェント CLI（claude / codex / agy）
`--worker-model-policy`	`inherit` / `fixed` / `delegate`
`--cwd` / `--clear-cwd`	master・solo を起動するフォルダ / 解除（絶対パスか `~/` 始まり。存在しないパスはエラー）
`--ctx-threshold` / `--clear-ctx-threshold`	自動ハンドオフを始めるコンテキスト使用率（%。50〜60。既定 60）
`--auto-handoff`	閾値を超えたら tako が引き継ぎを促すか（既定 true）

--cwd を設定すると、引き継ぎ（tako orchestrator handoff）で立つ後任 master もそのフォルダで起動します。未設定なら前任 master と同じフォルダを引き継ぎます（フックや direnv のようにフォルダに依存する設定が後任だけ効かなくなるのを防ぐため）。引き継ぎの応答には実際に使ったフォルダ（cwd）と決め手（cwd_source）が載ります。

master のエージェント CLI を codex にすると、tako master -<プロファイル名> で codex が tako の MCP ツールに接続された状態で立ち上がります。master が claude 以外のとき、プロファイルの model / effort は claude worker へ継承されません。

tako orchestrator accounts

worker ごとに別アカウントを使い分けるためのレジストリです。既定の資格情報をそのまま使うアカウントは --inherit で登録します（既定パスを明示指定すると警告が出ます）。

tako orchestrator accounts list
tako orchestrator accounts show work
tako orchestrator accounts add work --inherit
tako orchestrator accounts remove work

tako orchestrator spawn / run

子 worker をペインに起動し、プロンプトを渡します。

tako orchestrator spawn --project webapp --prompt "ログインページを実装して" --label login
tako orchestrator spawn --project webapp --prompt "..." --account work
tako orchestrator run --project webapp --prompt "テストを実行して失敗があれば直して"

`spawn` のオプション	必須	説明
`--project`	○	プロジェクトキー（登録済みのもの）
`--prompt`	○	worker に渡す初期プロンプト
`--label`		ペインタイトルに付けるラベル
`--account`		この worker だけ別アカウントで動かす
`--model` / `--effort`		モデル・思考量（省略時はプロファイル設定）
`--pane` / `--tab`		worker ペインをどこに出すか

run は spawn して run_id を返す非同期実行です。進捗と結果は次で回収します。

tako orchestrator run-status            # 全 run の一覧
tako orchestrator run-status <run_id>
tako orchestrator run-result <run_id>

`run` のオプション	説明
`--timeout <秒>`	完了待ちの上限（既定 1800 秒）
`--auto-close <true\|false>`	完了後にペインを自動で閉じるか（既定 true）
`--output-lines <N>`	回収する出力の末尾行数（既定 200）

tako orchestrator status / watch / report

worker の状態確認・完了待ち・報告取得です。

tako orchestrator status --pane 5
tako orchestrator watch --pane 5            # 完了までブロック
tako orchestrator watch --worker <ID>       # ペインが消えても追跡できる
tako orchestrator watch --pane 5 --timeout 600
tako orchestrator report --pane 5 --lines 2000
tako orchestrator report --pane 5 --messages 3   # 直近の発話だけ

watch は WORKER_IDLE（完了）/ WORKER_ERROR（異常停止）/ WORKER_GONE（消滅）などを 1 行で出力します。status はエラー時に種別（api_error / usage_limit など）と推奨アクションも返します。

自動ハンドオフ（コンテキストが埋まる前に master を交代させる）

master のコンテキスト使用率が閾値（既定 60%）を超えると、tako が master へ引き継ぎ開始を指示します。master は引き継ぎファイルを最新化して handoff を呼び、後任 master が引き継ぎ内容と実態を確認してから前任のペインを閉じます（後任の起動に失敗しても前任は残ります）。ユーザーの操作は要りません。

閾値は 50〜60% の範囲でプロファイルごとに変えられます。自動で促されるのが煩わしい場合は通知だけ切れます（handoff の手動実行は使えます）。

tako orchestrator profiles set default --ctx-threshold 55
tako orchestrator profiles set default --auto-handoff false

引き継ぎファイルは 2 つの節に分かれます。知識（マシン非依存） には決定事項・方針・残タスクの意図を、実行状態（このマシン限定） には worker とそのペイン番号や実行中のものを書きます。ペイン番号はそのパソコンでしか意味を持たないので、設定を別のパソコンと共有したとき（tako config）に知識だけが役に立つ形にしておくためです。節分けの無い古い引き継ぎファイルもそのまま読めます（後任には「番号は実際の画面で確認するように」が伝わり、次に更新されるときに 2 節へ書き直されます）。

引き継ぎはプロジェクトごとに 1 ファイル（handoff/projects/<プロジェクトキー>.md）です。交代のときに渡るのは、その master が担当しているプロジェクトの分だけなので、同じプロファイルを別のミッションで使っている master の話が混ざりません。プロジェクトに紐付かない運用知識だけを handoff/<プロファイル>.md（プロファイル運用メモ）に置きます。

古い形式（プロファイル単位の 1 ファイル）は自動で移行されます。 tako setup を実行したときと、master が引き継ぎを読むときの 2 か所で移行がかかり、何度実行しても壊れません。移行前のファイルは消さずに handoff/archive/ へ退避します。手で分割する作業は要りません。

tako orchestrator workers / respond / self / handoff / handoffs

tako orchestrator workers          # spawn 済み worker の一覧（ペインの生死と無関係）
tako orchestrator workers --all
tako orchestrator respond --pane 5 # 権限確認ダイアログへ応答（不在時はエラー）
tako orchestrator self             # master/solo が自分の pane・tab・コンテキスト残量と引き継ぎ閾値を知る
tako orchestrator handoff          # master のバトンを新しい master へ渡す
tako orchestrator handoff --projects tako,hero-cpp  # 渡すプロジェクトを明示する
tako orchestrator handoffs list                     # 引き継ぎファイルの一覧（行数・書式・肥大警告）
tako orchestrator handoffs show --project tako      # 1 件を読む
tako orchestrator handoffs write --project tako --content "..."  # 1 件を書く（標準入力も可）
tako orchestrator handoffs migrate                  # 古い形式を移行する（通常は自動で走る）
tako orchestrator layout --policy master-reserved --master-ratio 0.5
tako orchestrator supervisor       # worker 自動復旧 supervisor の操作
tako orchestrator ledger           # 委任台帳の操作

tako task

タスクのチェックポイントと受け入れゲート（完了条件）です。クラッシュや利用上限からの再開に使います。

tako task checkpoint <task_id>     # チェックポイントを記録・更新
tako task list
tako task resume <task_id>         # チェックポイントから worker を再開
tako task update <task_id>         # フェーズを手動で変更

# 受け入れゲート: 「これが通ったら完了」を機械で判定する
tako task gate set <task_id> --command "cargo test" --pr-merged 620
tako task gate check <task_id>
tako task gate show <task_id>

tako todo

ユーザー（人）がやることの一覧です。AI の承認待ち・生成物のレビュー・権限の確認・宣伝投稿のようにあなたの手が要るものを tako が溜めて促します。tako task（AI 自身のタスク）とは別物です。

返答（respond）は起票した master の入力欄へ届きます。master が閉じていれば、同じプロファイルの master を新しいタブで起動して初回メッセージとして渡します。配送の結果は tako todo show の 配送: 行で読めます。

同じことは PC の画面からもできます（右パネルの tasks ビュー = tako panel --show --view tasks）。一覧・詳細・返答フォーム・配送状態が 1 枚に並びます。詳しくは人がやること（ユーザータスク）を参照してください。

tako todo                            # （サブコマンド一覧）
tako todo list                       # 未完了の一覧 + 件数
tako todo list --all --json          # 完了・却下も含めて機械可読で
tako todo show u-1                   # 本文・添付・返答・配送状態

# 起票（ふつうは master / worker が MCP から行う）
tako todo add "解説動画 v6 を YouTube へ投稿" \
  --kind post \
  --body "サムネは docs/thumb.png。タイトルと説明は copy-text から貼れます" \
  --attach out/v6.mp4 \
  --copy-text "タイトル=tako v0.9 の解説" \
  --copy-text "説明=AI エージェントを 1 画面で監視する OSS ターミナル" \
  --link https://github.com/takushio2525/tako

# 返答する（起票した master へ届く）
tako todo respond u-1 --decision needs_change --comment "サムネの文字を大きく"
tako todo respond u-1 --decision approve

tako todo done u-1                   # 片付いた
tako todo dismiss u-1                # やらない

# 画面を動かす（AI が「これを見てください」と言うとき）
tako todo expand u-1                 # 右パネルの tasks ビューでその 1 件を開く
tako todo collapse                   # 開いているものを閉じる

expand は右パネルが閉じていれば開いて tasks ビューへ切り替え、その行の中身をその場に展開します（開くのは常に 1 件）。無い id を渡すとエラーになり、画面は動きません。いまどれが開いているかは tako todo list --json の expanded（画面が無ければ null）で読めます。

判断	意味	タスクの状態
`approve`	承認した	`done`（閉じる）
`reject`	却下した	`dismissed`（閉じる）
`needs_change`	直してほしい	`open` のまま（AI の作業が続く）
`answered`	質問に答えた	`open` のまま

tako agents

エージェント共通ルールを、各 CLI のグローバル指示ファイルへマーカーブロックで同期します。ブロックの外は書き換えません。

tako agents status
tako agents sync-rules

tako config

AI 系の設定を git リポジトリ 1 本でデバイス間共有します（任意機能）。claude のグローバル指示（CLAUDE.md / snippets / commands / templates）と tako の宣言的設定（profiles / projects / accounts / local-rules / settings）が対象です。

tako config                          # 配線状態と push / pull 待ちの差分
tako config list                     # 何を共有し何を共有しないかの分類表

# はじめる（どちらか）
tako config init                     # 新しく作る（~/tako-config-sync）
tako config init --remote [email protected]:you/tako-config.git
tako config link [email protected]:you/tako-config.git   # 2 台目: clone して配線
tako config link ~/dotfiles/tako     # 既存リポジトリに繋ぐ

# 同期
tako config push -m "[改善] プロジェクトを追加"
tako config pull
tako config unlink                   # 配線を外す（リポジトリは残る）

秘匿情報とマシン固有の状態は、除外リストではなくホワイトリストで構造的に外れます。カタログに載っていないファイルは共有されません。

共有される	共有されない
`CLAUDE.md` / snippets / commands / templates	`.claude.json` / credentials / 会話履歴
profiles / projects / accounts の宣言部 / local-rules	token / control.json / layout.json / sessions.yaml / workers.yaml / ペインログ
settings.json（表示設定）	アカウントの `config_dir`、profile の `env`、「バナーを閉じた」等の操作履歴

設定内の絶対パスは、ホーム配下なら ~/… に正規化して保存され、取り込み時にそのデバイスのホームへ戻ります。mac と Windows でホームの位置が違っても同じリポジトリを使えます。

`tako setup` からの配線

tako setup は質問を増やしません。完了サマリと tako setup --check に現在の状態（未配線 / 配線済み / 既に dotfiles などの git で管理されている）と次の一手が出るだけです。配線済みなら状態が 1 行出るだけで、設定を勧める案内は出ません。

設定したいときは、tako setup の最後に起動する対話アシスタントへ「別の PC でも同じ設定を使いたい」と頼めば、リポジトリの用意から配線まで代行してもらえます。

既に ~/.claude を dotfiles リポジトリで管理している場合は、二重管理にならないようそのリポジトリへの相乗り（tako config link <リポジトリ>）を先に提案します。別のリポジトリを新しく作ると、同じ CLAUDE.md が 2 か所で管理され、tako config pull の書き込みが symlink を実ファイルへ置き換えて既存の配線を壊すことがあります
何も無い場合は、gh にログイン済みならプライベートリポジトリの作成から配線まで代行できます。リポジトリの作成と push は必ず同意を取ってから行われ、tako setup --yes や非対話実行では一切起こりません

診断・保守

tako platform

この環境でどの機能が使えるか / 縮退しているか / 未実装かを表示します。GUI 不要のローカル処理です。

tako platform                       # 現在の環境の対応状況
tako platform --platform windows    # Windows 側の状況を macOS から確認
tako platform --status pending      # 未実装のものだけ
tako platform --json

tako agent-support

エージェント系統（claude / codex / agy / ローカル LLM）ごとに、どの機能が claude 同等に使えるか・縮退しているか・まだ使えないかを表示します。worker を codex / agy で立てる前と、その worker が期待どおり動かないときに引くコマンドです。

tako agent-support                        # 全系統ぶんの表
tako agent-support --agent codex          # 系統を 1 つに絞る
tako agent-support --status unsupported   # 上流の CLI に手段が無いものだけ
tako agent-support --json

その他

tako fda status              # フルディスクアクセスの付与状況
tako fda open                # システム設定を開く

tako sleep-guard status
tako sleep-guard set --mode while-agents-running --power-condition ac-only

tako sleep-guard install-lid-sleep                     # 蓋を閉じても動かし続ける（初回登録）
tako sleep-guard set --lid-power-condition always      # バッテリー駆動でも継続する（既定は AC のみ）
tako sleep-guard set --lid-battery-floor 30            # 残量の下限（既定 20%。ここまで下がると自動解除）

tako telemetry status        # エラーレポート自動送信（既定 OFF）
tako telemetry on
tako telemetry off

tako stale-binary            # 稼働中セッションの claude バイナリの鮮度確認・張り直し

tako check-health            # 環境の健全性診断（CLI の PATH・tmux・IPC の受け口）
tako check-health --json     # 生の JSON（アプリへ届かないときは受け口だけをローカル診断）

tako shell-integration           # シェル統合（cwd 追従・コマンド実行状態）が効いているか
tako shell-integration install   # 配置する（unix は環境変数の注入で完結するので不要）

tako context-budget          # 起動時ロードの予算の確認（何も書き換えない）
tako context-budget fix      # 積もった作業ログを archive へ移送する

tako test-residue            # テスト・検証が残した一時 dir の下見（1 つも消さない）
tako test-residue --apply    # 実際に削除する（生きているプロセスの置き場には触らない）

MCP

tako mcp serve

MCP の stdio ブリッジ（AI エージェントと tako をつなぐ中継役）として動作します。通常は手で実行するものではなく、tako setup-mcp で登録するとエージェント側が自動的に起動します。tako の外で起動された場合は安全のためツールを公開しません（0 ツールで応答）。

tako mcp serve