clikae を使う

clikae はそれ自体が動詞です（切り替え、switching）。中心となる操作には専用の動詞がありません。プログラム名そのものが動詞です。

clikae <engine> <tank>      # switch <engine> to <tank> and run it

<engine> はアダプタを備えた CLI（clikae adapters で一覧）、<tank> は 1 つのアカウントや設定に付ける、あなたが決める名前です（使える文字は A-Z a-z 0-9 . _ -）。全体を通して燃料のたとえが流れています。タンクはエンジンのクォータ（その燃料）を蓄え、タンクが空になったら clikae to で作業を次へ運んでいきます。

コマンドごとの詳しいリファレンスは clikae help <command> で見られます。言語の設計全体は grammar.md にまとめてあります。

クイックツアー

# Create a tank for Claude Code, and add the matching shell alias
clikae init claude work --alias

# Switch to it and run — the bare verb (no `run` needed)
clikae claude work
clikae claude work -- --help    # args after -- go straight to the engine

# Or pick up the alias and use that
source ~/.zshrc                 # or your rc file
claude-work

# Generate a macOS launcher you can double-click from ~/Applications
clikae app claude work

# See what you've got
clikae tanks                    # alias: clikae list
#   ENGINE       TANK
#   claude       work
clikae tanks -p                 # also print the tank directory paths

# Tear it all down (tank dir + alias + .app, asks to confirm)
clikae remove claude work

コマンド

clikae 自体が動詞なので、切り替えに動詞は要りません。管理系のコマンドは、ふつうの素直な動詞をそのまま使います。

切り替え（いちばん大事なところ）

タンクを作る・管理する

Ghostty のランチャーは、コマンドを -e ではなく信頼された Ghostty の設定ファイル（--config-file=）経由で渡します。Ghostty は外部から注入された -e コマンドに対して「Ghostty にこの実行を許可しますか？」というダイアログを出すため、-e のランチャーは Allow を押すまで空のシェルのように見えます。設定ファイルは信頼されているので、ウィンドウはそのまま開きます。この設定は .app の中に置かれ、path to me 経由で見つかるので、ランチャーを移動しても動き続けます。

タンクが空になっても燃やし続ける

監督付き起動（BETA・claude・フィードバック歓迎）。 claude を clikae 経由で起動すると、clikae が親プロセスとして残り続けます。そのセッションが上限に達して終了したとき — 対話実行なら死んだセッションを終了させ、ヘッドレスの claude -p は自分で終了します — clikae が clikae auto の設定に従って、同じターミナルであなたを burn order の次のタンクへ運び（再描画 1 回）、会話はそこで続きます。正直に言うと、進むのは終了時であって、稼働中のセッションを途中で殺すわけではありません（それにはエンジン側の対応が必要です。issue anthropics/claude-code#35744 を参照）。1 回の実行につき 1 ホップ。対話モードの codex は（ファイルの手がかりがなく）自動検出できないため、今のところ claude 専用です。clikae 経由で起動したものでない限り、バックグラウンドでは何も動きません（デーモンなし）。これは意図的な設計です。何を運んだか（直近の引き継ぎ）は clikae status で確認できます。使い心地をぜひ教えてください。

状態を見る

Antigravity（agy）— 同じ動詞、1 つのパワーモード

agy は ~/.gemini をハードコードしていて環境変数を無視するため、clikae は他のエンジンのようにシェルごとに切り替えることができません。それでも、オプトインのシンボリックリンク入れ替え（パワーモード）によって、同じ動詞の中に収まります（グローバル：すべてのターミナルを通じて一度に 1 つのタンクのみアクティブ。元に戻せます）。

シェル

clikae は $SHELL からあなたのシェルを自動検出し、正しい rc ファイルにエイリアスを書き込みます。zsh（~/.zshrc）、bash（macOS では ~/.bash_profile、それ以外は ~/.bashrc）、fish（~/.config/fish/config.fish）に対応します。fish に対しては fish の構文 — alias <name> 'env VAR=val <binary>' — を出力します。fish にはインラインの VAR=val cmd がないためですが、結果としての挙動は同じです。clikae remove はいずれのシェルでもそのブロックを片付けます。

既存の構成を移行する

すでにアカウントを手作業でやりくりしている — たとえば ~/.claude-acct-a / ~/.claude-acct-b のペアを ~/.zshrc のエイリアスで使い分けている — としましょう。clikae migrate はそれを clikae に取り込みます。

clikae migrate --dry-run   # preview: which dirs move where, which aliases change
clikae migrate             # do it (asks to confirm first)

シェルの rc を走査して、エンジンの設定環境変数を立ててエンジンを呼び出しているエイリアスを探します。見つけたものごとに、次を行います。

1. 参照している設定ディレクトリを ~/.clikae/profiles/<engine>/<p>/ の下へ移動し、
2. エイリアスを clikae 管理のセンチネルブロックに書き換えます。

rc ファイルはまず <rc>.clikae.bak.<timestamp> にバックアップされ、既存の clikae タンクが上書きされることは決してありません。別のツールのエイリアスを移行するにはエンジン名を渡します（clikae migrate gh）。既定は claude です。

⚠️ 使用中の設定ディレクトリは移行しないでください。 migrate はディレクトリを移動します。そのため、いままさにそれに対してプロセスが動いている場合（たとえば CLAUDE_CONFIG_DIR が移動対象を指している、まさにその claude セッションの中から clikae migrate を実行した場合）、稼働中のプロセスの足元からディレクトリを抜き取ってしまいます。書き込みに失敗したり、元のパスに空のディレクトリを作り直したりして、中途半端な状態が 2 つ残ることがあります。migrate は、そのエンジンのインスタンスが動いていない、まっさらなシェルから実行してください。--dry-run は常に安全です。

v0.4 以降、migrate はこの最もよくある形を防ぎます。$CLAUDE_CONFIG_DIR（またはアダプタが使ういずれかの環境変数）が移動予定のディレクトリを現在指している場合、実行を拒否し、まっさらなシェルからやり直すよう伝えます。このガードは --force でも回避できません。これはあなたのデータを守るためのもので、確認のためのプロンプトではありません。

🔑 macOS + claude：移行したタンクごとに一度の再ログインを見込んでください。 macOS では、Claude Code はログイントークンを CLAUDE_CONFIG_DIR の中ではなくログインキーチェーンに保存します。そしてそのキーチェーンの項目は設定ディレクトリのパスをキーにしています。migrate がディレクトリを新しいパスへ移動するため、claude はトークンを見つけられなくなり、移行したタンクごとに一度ログインを求めます。データは無傷で、移動についていかないのは保存済みのログインだけです。再ログインを避けたい場合は --keep-login を渡してください。これは旧パスのキーチェーン項目から保存済みトークンを新しい項目へコピーします（macOS のみ。トークンをどこかへ読み出したり送信したりすることは決してなく、キーチェーンの中に留まります）。macOS がキーチェーンへのアクセス許可を求めることがあります。

使用上限に達したらセッションを運ぶ — clikae to

これこそが clikae の生い立ちです。1 つのアカウントのクォータが作業の途中で尽きるからこそ、2 つ目のアカウントを持っておく。clikae to は、まさに燃料タンクを差し替えるように作業を次へ運び、新しいクォータの上で同じ会話を続けさせます。

# You're working on claude tank `a` and just hit its limit. From the same project
# directory, carry the conversation onto another tank and keep going:
clikae to b                     # same engine → a real resume, on b's quota
clikae to codex                 # a different engine → a written brief (cold start)
clikae to codex work            # cross to a specific tank of another engine

clikae は、このシェルがどのエンジン + タンクにいるかを自動検出します。まず生きている環境変数を見て、次に — むき出しの切り替え/エイリアス/.app はエンジンを、親シェルに届かない前置代入付きで実行するため — このディレクトリで直近のセッションを持つタンク（ついさっきまでここにいたもの）を見ます。だから switch → work → to が 1 つのシェルで成り立ちます。代わりにシェルをタンクへ明示的に固定したい場合は eval "$(clikae env <engine> <tank>)" を使ってください。ターゲットはエンジン名を優先して解決されます。既知のエンジン名ならそこへ渡り、それ以外なら現在のエンジンのタンク扱いです。clikae はどの仕組みを使ったかを必ず知らせるので、レジュームかブリーフかを推測する必要はありません。

同じエンジン（レジューム）。 Claude Code の場合、clikae はソースタンクの下から現在のディレクトリの直近のトランスクリプトを見つけてターゲットタンクへコピーし、そこで claude --resume <id> を実行します。会話は続きますが、新しいやり取りはすべてターゲットタンクのクォータを消費します。ソースタンクには一切触れません（コピーするだけで、移動はしません）ので、いつでも戻れます。何かが動く前にプレビュー + 確認が表示されます。-y はそれを省き、--fresh は何も運ばずにタンクだけ切り替え、--session <id> は特定のセッションを運びます。

引き継ぎは Claude Code のディスク上のトランスクリプト構造（<config-dir>/projects/<slug>/<id>.jsonl）と --resume に依存しています。現行の Claude Code に対して検証済みです。将来のバージョンでこの構造が変わった場合は、破壊的なことをするのではなく、まっさらな状態からの開始にフォールバックします。

別のエンジン（ブリーフ）。 別のモデルやベンダーは、よそのセッションをレジュームできません。共通のトランスクリプト形式がないからです。そこで clikae は引き継ぎブリーフ（何をしているか、何が済んだか、次は何か）を書き起こし、それを冒頭のプロンプトとして種にしてターゲットエンジンを起動します。clikae は要約を自動で書こうとします。ローカルモデルの CLI が PATH にあれば（apfel、ollama、llm）、それを使ってブリーフを無料で要約します。CLIKAE_HANDOFF_AUTOLOCAL=0 でこの自動検出を無効にできます。それ以外の場合、ブリーフは生の抜粋（セッションのメタデータ + あなたの最近のプロンプト）になり、生であることが明示されます。特定の要約器を使わせるには、clikae に任意のモデルを指定してください。そうすれば、ちょうど空になったタンク上でブリーフを書くコストがゼロになります。

export CLIKAE_HANDOFF_SUMMARIZER='llm -m my-local-model'   # any stdin→stdout command
clikae to codex                                            # the model writes the brief

要約器（自動検出されたものか CLIKAE_HANDOFF_SUMMARIZER）は、標準入力で指示行とそれに続くセッショントランスクリプトの末尾を受け取り、ブリーフを標準出力に書き出します。何も出力しなければ、clikae は生の抜粋にフォールバックするので、引き継ぎが失われることはありません。どれだけのトランスクリプトを渡すかは $CLIKAE_HANDOFF_LINES（既定 60）で調整します。次へ運ぶ動作はソースに対して読み取り専用で、ソースのセッションやどのタンクにも触れません。

内部では、clikae to は relay（同じエンジン）または handoff（別のエンジン）に委譲します。どちらも隠しエイリアスとして使えます。たとえば clikae handoff claude --out HANDOFF.md は、何も起動せずにブリーフをファイルに書き出すだけです。詳しくは clikae help to / help relay / help handoff を実行してください。

アンビエント：空のタンクを察知して切り替える（watch）

手作業で切り替える代わりに、タンクが空になる瞬間を clikae に見張らせ、次のタンクへ流れさせましょう。あなたのタンク群がそのまま予備で、用意するものは何もありません。 今のセッションを見張るだけです。

clikae watch claude            # offer to switch to the next claude tank when dry
clikae watch claude --auto     # switch automatically (asks once for consent)
clikae watch claude --to codex/work   # cross to a specific tank/engine instead

空のタンクを検知すると、同じエンジンの次のタンクへ運びます（それ自体がクォータ切れのものは飛ばします）。エンジンまたぎには明示的な --to が必要です。既定ではまず確認します。--auto は一度きりの同意のあと自動で切り替え（同意は $CLIKAE_HOME/auto-relay-consent に記憶されます。取り消すにはそのファイルを削除してください）、何をしたかは常に伝えます。

正直な注意点。 対話式のエンジンは使用上限に達しても終了せず、コードも返さず、フックも発火しません。だから clikae が見張れるのは、上限がディスクに書き残すものだけです。claude ならセッショントランスクリプト、agy なら ~/.gemini/antigravity-cli/cli.log（agy の -p 実行は空の出力で 0 終了するため、ログ行だけが手がかりです）。codex の上限はトランスクリプトに永続化されないことが確認済みなので、codex についてはディスクから空のタンクを検知できません。実際に初めて上限に当たったとき、マッチを確認・調整してください。

clikae watch claude --check          # would the pattern fire on this session?
CLIKAE_LIMIT_PATTERN='…' clikae watch claude   # override the match

タンクをまたぐヘッドレスタスク — clikae burn

watch/auto は対話式のセッションを運びます。ヘッドレスな力仕事 — 「安いタンクに汚れ仕事をさせる」ケース — には clikae burn を使います。これは 1 つのタスクをタンク上で実行し、肝心なことに、本当に終わったかどうかを把握します。確認には、タスクが必ず生み出すべき**成果物（artifact）**を使い、終了コードは決して当てにしません（codex exec は使用上限に当たって何も書かなくても 0 で終了します）。タンクが空だったら、同じタスクを予備の次のタンクで撃ち直します。

# Distil a file with codex on tank M; if M is dry, fall through to your next
# codex tank automatically. Success = /tmp/out.md exists.
clikae burn codex M --artifact /tmp/out.md -- \
    exec -C /tmp -s workspace-write "read /tmp/in.txt, write /tmp/out.md"

clikae burn codex M --artifact /tmp/out.md --to codex/H -- exec … "<task>"   # explicit next hop
clikae burn codex M --artifact /tmp/out.md --timeout 300 -- exec … "<task>"  # bound a long run

結果：成果物あり → 完了。届く範囲のすべてのタンクが空 → 失敗。実行したが成果物を生まず、上限も出していない → 本物のタスク失敗（どこでも同じように失敗するので、ルーティングし直しません）。--no-reroute は一度だけ実行し、空のタンクで止まります。

burn は単一タスクの単位です。バッチ処理や並列はあくまであなたのオーケストレーターの仕事です（複数の burn を扇形に展開し、成果物を確認してください）。タスクは冪等で成果物チェック付き（入出力パスを固定）にし、入力は遅い iCloud バックアップの I/O をタンクに渡すのではなく、あらかじめ /tmp に置いておきましょう。

burn は、あなたが使っているクォータは消費しません。 自動ルーティングは、対話式セッションが生きているタンク（さもなければ進行中の会話を燃やしてしまいます）と、すでに空のアカウントを共有するタンクを飛ばします。使用中スキップを上書きするには --allow-active、ホップを明示するには --to <tank> を渡してください。

タンクはクォータの供給源であって、中身そのものではありません。 burn <engine> <tank> はコマンドを動かすためにそのタンクのクォータを使います。コマンドが読み書きするのは単なるファイルで、タンクとは無関係です。だから、安いタンクのクォータを使ってどんなファイルでも — 別のタンクのトランスクリプトさえ — 噛み砕けます。

agy を安い読み取り専用ワーカーとして使う。 agy は burn のタンクにはなれません（1 つのグローバルアカウントなので、ルーティングし合う予備がありません）が、ヘッドレスワーカーとしては優秀です。burn の予備ラッパーの外で、直接呼び出すだけです。

# agy as a summariser — content in via stdin, agy's own quota spent. Read-only.
cat /tmp/in.md | agy --sandbox -p "summarise this"  > /tmp/out.md

# …or through clikae, on a specific agy account (switches the global ~/.gemini
# symlink to tank R, then runs agy headless on R's quota):
clikae agy R -- -p "summarise this" --sandbox  < /tmp/in.md  > /tmp/out.md

ここでは burn の 2 つの保証を手放すことになります（空 → ルーティングなし。agy はアカウントが 1 つなので、空のままだと単に失敗します。成果物の検証もなし）。それから、clikae agy が切り替えるのはシェルごとの環境ではなくマシン全体のシンボリックリンクであること（そして agy には --model フラグがなく、モデルはアプリの設定であること）を覚えておいてください。

どのタンクにいるかを確認する

clikae status            # every engine that has a tank
clikae status claude     # just one

#   ENGINE       TANK         ACCOUNT          SOURCE
#   claude       cver         hi@cver.net      CLAUDE_CONFIG_DIR=…/profiles/claude/cver
#   aws          (default)    -                AWS_PROFILE unset — system default

status は現在のシェルにおける各アダプタの環境変数の生きた値を読み、それを clikae のタンクへ逆引きします。これはシェルごとの見え方です。別のターミナル（あるいは別の clikae app から起動したもの）は、別のタンクにいることがあります。(default) は環境変数が未設定（エンジン自身の既定）を意味し、(external) は clikae のタンクではないどこかを指していることを意味します。ACCOUNT 列は、アダプタが判別できる場合にログイン中のアカウントを表示します。

タンクの名前を付ける

タンクには、あなたにとって意味の通る名前を付けてください — work、personal、顧客名、あるいはアカウントのメールアドレスでも。素の a/b が何を指していたかを覚えておく必要はありません。tanks も status も、アダプタが読み取れる場合はログイン中のアカウントを表示します。

名前を考え直しましたか？ clikae rename はディレクトリを移動し、管理下のエイリアスを書き換え、そして — macOS の claude については — 保存済みのキーチェーンのログインを引き継ぐので、ログインし直す必要はありません。

clikae rename claude a cver        # a → cver; login + alias follow

新しい名前がすでに使われているか、そのエンジンがこのシェルでそのタンクを現在使っている場合は拒否します（まっさらなシェルから実行してください）。既存の .app ランチャーはそのまま残りますが、フラグが立ちます。clikae app claude cver で作り直してください。

揮発する記憶（--ephemeral）

外科的に、痕跡を残さない実行のために：clikae claude work --ephemeral はタンクに切り替えて実行しますが、エンジンの長期記憶を、エンジン終了時に破棄される使い捨てのディレクトリへ向けます。タンク本来の記憶は脇へ退避され、そのまま元へ戻されます。

clikae claude work --ephemeral     # incognito: nothing learned this session is kept

• ログインとトランスクリプトは通常どおりで、使い捨てなのは記憶ストアだけです（あなたはあなたのままで、会話も記録され、レジューム可能です）。
• 正直な範囲： clikae が保証するのは記憶ディレクトリが使い捨てであることだけです。エンジンが「どこにも何も覚えていない」とは約束できません。キャッシュ、シェルの履歴、テレメトリ、macOS のキーチェーンは clikae の手の届かないところにあります。だからこれは揮発する記憶であって、完全な記憶喪失を保証するものではありません。
• 記憶のレイアウトを clikae が把握しているエンジン（現在は claude）でのみ対応します。それ以外はその旨を伝えて終了します。
• 通常の切り替え（エンジンを exec します）と違い、--ephemeral は終了時に後片付けを走らせられるよう、エンジンを子プロセスとして実行します。クラッシュした実行は、次の --ephemeral で自己修復します（本来の記憶が退避先から復元されます）。

仕組み

各タンクについて、clikae は次を行います。

1. ~/.clikae/profiles/<engine>/<tank>/ を作成します。これがエンジンの環境変数（例：CLAUDE_CONFIG_DIR）の指すディレクトリです。（ディスク上のパスは安定性のために profiles という語を保ちますが、あなたが入力・目にするのは常にタンクです。）
2. （alias）シェルの rc にセンチネルで囲まれたブロックを追記します。

   # >>> clikae:claude.work >>>
   alias claude-work='CLAUDE_CONFIG_DIR="/Users/you/.clikae/profiles/claude/work" claude'
   # <<< clikae:claude.work <<<
   

   このセンチネルにより、安全で正確な削除が可能になります。
3. （app、macOS）AppleScript でコンパイルした .app を生成します。これはターミナルを開き、環境変数を前置したエンジンを実行し、ウィンドウのタイトルを claude (work) に設定して、ウィンドウを見分けられるようにします。ターミナルは既定で Terminal.app です。--terminal iterm2 と --terminal ghostty はそれぞれを対象にします（既定を変えるには $CLIKAE_TERMINAL を設定してください）。Terminal.app と iTerm2 は AppleScript で駆動します。Ghostty には macOS でウィンドウを開く CLI がないため、そのランチャーは open -na Ghostty.app --args … -e … を経由します。

デーモンなし、グローバルな状態なし、ネットワーク呼び出しなし。すべての行を読めます。

対応エンジン

flag 戦略は、設定ディレクトリの環境変数を持たないエンジン向けです。エクスポートした変数の代わりに、生成されたエイリアス/.app/実行コマンドの中で、タンクのディレクトリをコマンドラインフラグ（例：vercel の --global-config）として注入します。そうしたエンジンは clikae status で (n/a) と表示されます（環境から読み戻せるものがないためです）。

clikae adapters を実行すると、説明付きで一覧を見られます。自前で追加するのは bash 約 10 行ほどです — adding-an-adapter.md を参照してください。

aws についての注意： 他と違い、AWS アダプタは設定を別のディレクトリに隔離しません。AWS_PROFILE は、既存の ~/.aws/config から名前付きプロファイルを選びます。そのため clikae init aws work は、対応する [profile work] の項目が存在することを前提とします。代替となる env-file 方式については、lib/adapters/aws.sh の冒頭のコメントを参照してください。