clikae の文法と用語 — 唯一の信頼できる情報源

このドキュメントは、clikae のコマンド文法（grammar）と語彙（lexicon）を定義します。 これが唯一の信頼できる情報源（SSOT）です。bin/clikae（ディスパッチ）、 lib/commands/help.sh、ユーザーの目に触れるすべての文言、ホームダッシュボード、 そしてドキュメント類は、すべてここに書かれている内容に従います。文法とコードが 食い違ったときは、文法が正です — コードのほうを直してください。

コマンド表面やユーザー向けの文言に手を入れる前に、最後まで通して読んでください。

0. 核心となる一つの考え

clikae は動詞です。 名前は CLI ＋ kae（切り替え、kirikae —「切り替える」） からできています。このツールの仕事はまるごと切り替えなので、clikae という語自体が すでに「切り替える」を意味しています。文法はこの考えの上に組み立てられています。

• 看板となる操作 — CLI をあるタンク（tank）に向けて起動する — には、動詞がまったく 要りません。動詞はプログラム名そのものだからです。clikae claude work は 「claude を work に切り替える」と読めます。覚えることは何もありません。 clikae の意味はもうわかっているはずです。
• 切り替えでない操作（作成、削除、確認、監視）には、明示的でありふれた動詞を そのまま使います。

これは凝った動詞を発明するのとは正反対です。私たちは run を burn に リネームしたりはしません。プログラム名がすでに動詞を担っているところでは動詞を 省略し、それ以外ではどんなパワーユーザーも手に覚えているありふれた動詞を使います。

1. 二つの層、一つのルール

インターフェースは慣習に従う。メタファーはモデルの中に宿る。

メタファーが満たすべきテスト： 理解の助けにはなってよい。操作に必要であっては ならない。clikae run claude work に物語は要りません。メタファーを読み解かないと 使えない動詞を、私たちは決して出荷しません。

2. 用語（名詞）

profile と slot はユーザー向けの文言から退役しました。 これらは内部識別子と ディスク上（~/.clikae/profiles/<engine>/<tank>/、profile_dir、profiles_root）でのみ 生き残ります — ストレージのレイアウトや中核関数をかき回したりはしません。ユーザーが 目にする言葉はただ一つ、tank です。

3. 文法（動詞）

3.1 切り替え — 省略された動詞

3.2 セッションを運ぶ — to

to は 「いまの作業を一緒に連れていく」 ためのマーカーです。clikae to codex は 「codex に切り替える」と読め、まっさらに始めるのではなく現在のセッションを運びます。

ソースは自動検出されます。まず実行中の環境変数、次に — 素の切り替え／エイリアス／.app はエンジンを prefix 代入付きで起動し、それが親シェルには届かないため — このディレクトリで 最も新しいトランスクリプトを持つタンク（ステートレス、「さっきここにいたセッション」）を 見ます。シェルをあるタンクに明示的に固定したいときは eval "$(clikae env <engine> <tank>)" を実行します。clikae はどの仕組みを使ったかを常に告知するので、resume か brief かの 違いは覚える必要なく実行時に示されます。

✓ carried your live session → claude/personal (thread resumed)
⚠ codex can't resume a claude session — handed it a written brief (cold start)

正確に（タンクは燃料以上のものを保持する）。 to が運ぶのはセッションの トランスクリプト — スレッドは続きます — であって、エンジンの長期記憶ではありません。 長期記憶はタンクのディレクトリ内（例：CLAUDE_CONFIG_DIR 配下にある claude のファイル メモリ）にあり、ソース側のタンクに残ります。つまり「再開」とは会話のことであって、 頭脳のことではありません。タンク間でメモリを運ぶ／共有することは、別個の、将来の オプトイン機能です（§10 のリンク／オーバーレイ案を参照）。「コンテキストはそのまま」と 言わないでください。

to の引数は、まずエンジン名、次に現在のエンジンのタンクとして解決されます （ステートレスで予測可能：既知のエンジン名なら常にそこへ渡る）。明示的に区別したいときは clikae to <engine> <tank> とします。clikae は何を解決したかを常に告知するので、推測が 外れても目に見え、訂正できます。

3.3 管理 — ありふれた慣習的な動詞

これらは切り替えではないので、明示的でありふれた動詞をそのまま保ちます。燃料の言葉を 無理に押し付けたりはしません。

4. 構文解析と優先順位

bin/clikae は最初の引数を次の順で解決します。

1. 予約コマンドか？（init、remove、list、tanks、status、to、 watch、auto、burn、conduct、rename、git-id、migrate、env、app、alias、 lang、run、continue、relay、handoff、doctor、info、adapters、 demo、home、help、version、加えて agy／dashboard／ls／rm のエイリアスと -h/--help/-v/--version）→ そのコマンドを実行する。（git-id は git_id.sh コマンドへルーティングされる — - を _ にしたファイル／関数を持つ 唯一の動詞。）
2. そうでなければ、既知の CLI か？（lib/adapters/ のアダプタ、または lib/targets/ のターゲット、例：claude、codex、agy）→ §3.1 の素の切り替え。
3. それ以外 → 不明。エラー＋help を表示する。

驚かれないよう、その帰結も明文化しておきます。

• 予約コマンドが勝ちます。もし予約語そのままの名前を持つ CLI があった場合は、明示的な エイリアス経由で到達します：clikae run <engine> <tank>。
• clikae <engine> --help は曖昧なので推測しません。clikae 自身のヘルプは clikae help <engine>、CLI 向けのフラグは -- の後に置きます （clikae <engine> <tank> -- --help）。

5. to の落とし穴 — そしてその無害化のしかた

clikae claude work（まっさらに開始）と clikae to claude work（セッションを運ぶ）は 一語しか違いません。素の切り替えは何も壊しません — 元のタンクのトランスクリプトは あとで to で戻れるようにちゃんと残っています — ので、to を忘れたコストはたいてい 一手の無駄で済み、回復できます。

本当に痛むのはただ一つ、いまいるタンクがちょうどガス欠になったときです。限界に ぶつかって、続けたいのに、黙ってまっさらに始まるのは意図の真逆です。だから緩和策は 意図的に狭く — そこでのみ発火します。

緩和策（オプション B）： 素の切り替えは、一般的にセッションを意識するのではなく、 ガス欠を意識します。clikae <engine> <tank> が呼ばれたとき、そのエンジンで現在 いるタンクが**枠を超えている（dry）**場合、clikae は黙ってまっさらに始めません。TTY では こう尋ねます。

claude/main is out of fuel right now.
  ❯ Carry this session over to work   (= clikae to)
    Start work fresh

非対話的（パイプ／スクリプト）にはまっさらに開始をデフォルトとしつつ、こう表示します： hint: to continue this session, use clikae to claude work。

現在のタンクがガス欠でないときは、素の切り替えは静かに即座に行われます — 別のタンクへの 切り替えはおそらく意図的なものだと尊重するからです。これにより、ただ一つのプロンプトを、 製品の核心の瞬間（ガス欠 → タンクの差し替え）にぴたりと置き、それ以外の場所には置きません。

6. Antigravity（agy）も同じ文法に畳み込まれる — 特別な動詞なし

このエンジンの正典の名前は agy です — それがこの CLI が自分自身を呼ぶ名前であり、 エンジン引数は常にバイナリ名（claude、codex、gh）というルールに一致します。 Antigravity は文章や UI のタイトルで使う固有名（「Antigravity (agy)」）であり、 antigravity は隠れた長い形のエイリアスとしてのみ生き残ります。あなたが入力するのは agy です。

agy は ~/.gemini をハードコードし、あらゆる環境変数を無視し、config ディレクトリの フラグも持たないため、他のエンジンのようにシェルごとに切り替えることができません。clikae は ~/.gemini をシンボリックリンクでタンクディレクトリ間で差し替えることで対応します — 機械全体で 一度に一つのタンクだけが有効になる、グローバルなパワーモードです。ユーザーがこのために 別個のコマンドツリーを覚えることはありません。agy は他のすべてと同じ動詞を使い、 特別なサブコマンドはゼロです。

clikae agy disable / antigravity disable はありません — それは素の切り替えと 衝突します（clikae agy <tank> は disable でも何でもタンク名として読む）。解体は remove（最後のタンク）と --release フラグに置かれています。

要点：

• agy は多くのタンクを持てます（好きなだけ保管できる）。ただし機械全体で一度に 有効にできるのは一つだけです — agy のエンジンは単一のハードコードされた燃料ライン （~/.gemini）を持つからです。ボードの ● がそれを可視化します。
• 警告と確認は初回の引き取りのときだけ（本物の ~/.gemini を管理下のシンボリック リンクに変えるとき）に行われます。以降の init agy <tank> は素の mkdir で、 init claude と同じ摩擦です。
• agy は relay／to のターゲットにはなれますが（clikae to agy → ブリーフ＋起動）、 ソースにはなれません（その .pb トランスクリプトは不透明）。watch agy は 通知のみです。

7. 後方互換（隠れエイリアス）

これらは動き続けますが、clikae help では宣伝されません（clikae help <cmd> には 現れることがあります）。

スクリプトや CI では、簡潔さより明確さが勝つ場面では明示的なエイリアス（clikae run …）を 優先すべきです — まさにそのためにあるものです。

8. ヘルプは省略形を先頭に置かねばならない

素の切り替えには動詞がないため、教えられない限り見えません。ホーム画面（素の clikae）と clikae help は、これを冒頭に置かねばなりません。

clikae <engine> <tank>     switch <engine> to <tank> and run it      ← the main thing
clikae to <where>       carry your current session elsewhere
clikae                  your tank board
clikae init <engine> <tank>   create a new tank
clikae help                full command reference

9. 実装チェックリスト（コードをこのドキュメントに合わせる）

• ディスパッチ（bin/clikae）：§4 の第一引数リゾルバ — 予約コマンド → 素の切り替え（既知の CLI）→ エラー。to と tanks を配線し、run、 continue、relay、handoff を隠れエイリアスとして保つ。
• 素の切り替え：<engine> <tank> を既存の cmd_run パス（env 適用＋exec）に 通す。§5 のセッションを意識したプロンプトを追加する。
• to：ソースを自動検出し、resume（同じ CLI）か brief（別の CLI）かを選び、 どちらを使ったかを告知する単一のコマンド。今日の relay ＋ handoff のふるまいを その背後に畳み込む。
• agy：init ／素の切り替え／remove で cli ∈ {agy, antigravity} を load_adapter の前に横取りする（agy にはアダプタがない）。初回の init agy は 警告と確認の引き取りを実行する。素の切り替えはスロット選択＋起動＋グローバル通知を 行う。最後のタンクの削除は解体を提案し、clikae agy --release が タンクは残して解除を扱う。disable サブコマンドはなし（素の切り替えと衝突する）。 正典のエンジン名は agy。antigravity は隠れた長いエイリアスになる — 旧来の cmd_antigravity サブコマンドツリーを廃止する。
• 文言の一掃：help.sh、list ヘッダー（PROFILE → TANK）、 init／run／remove のプロンプト、エラー文字列、ホームダッシュボードにわたって profile／slot → tank（別名 profile）。ディスクレイアウトと中核関数名は profile のまま。
• ヘルプ：cmd_help を §8 に書き換える — 省略形を先頭に。
• ドキュメント：usage.md / README.md をこの文法に合わせて更新する。 推奨の表面から run と relay／handoff を一掃する（エイリアスとしては残す）。
• テスト：第一引数の解決、to の落とし穴プロンプト（TTY か非 TTY か）、 agy の畳み込み、後方互換エイリアスについて bats を書く。
• PowerShell ミラー：該当する箇所では同じ文法を Clikae.psm1 に反映する。

10. 設計の未踏領域 — タンクは燃料以上のものを保持する

並行セッション（枠超え検出の作業、プロファイル b、2026-06-01）からの寄与。ここには 未踏領域として記録しており、まだ決定ではありません — モデルに畳み込むかどうかは メンテナーの判断です。

緊張の在りか。 §2 は燃料＝枠、タンク＝一つのアカウント／設定だと言います。本当 ですが、タンクディレクトリは燃料よりはるかに多くを保持します — エンジンの長期記憶と あらゆるトランスクリプトです。燃料は代替可能ですが、メモリはそうではありません。だから 「タンクを差し替えて、燃やし続ける」は、ひそかにエンジンの頭脳まで差し替えています。 （証拠：claude のファイルメモリは CLAUDE_CONFIG_DIR の中にあるので、profiles/claude/a と …/b はまったく別のメモリストアを持ちます — 命名規則すら別々に漂流してきました。 タンク間でメモリが伝わるのは、手作りのブリッジを通したときだけです。）

統一されるパターン。 agy の ~/.gemini シンボリックリンク差し替え（§6）は単発の 特例ではありません。clikae は、自分の状態がどこにあるかをハードコードし、それが望む カーディナリティと噛み合わないエンジンに何度もぶつかります — そしてその修正は常に、その 対応関係を作り直すためのファイルシステム的な間接化です。

同じプリミティブ、三つの方向。協力的なエンジン（claude／codex／gh）が易しいケース です — 環境変数なので、env-dir／env-file／flag がそれを指すだけです。agy とメモリが、 同じ道具を欲しがる絡み合ったケースです。

検討すべきアイデア： env-dir／env-file／flag と並ぶ第四の戦略 — リンク／オーバーレイ戦略。これは（a）agy を「ターゲットであってアダプタではない」という 変わり種ではなく筋の通った戦略にし、（b）タンク間メモリ共有に居場所を与え（警告付き・ 可逆のオプトインで、一つの共有メモリストアを各タンクにシンボリックリンクする — §6 と 同じインフォームド・コンセント方式）、（c）to のトランスクリプト運搬を同じ系譜につなげ ます。つまり「agy が同じ文法に畳み込まれる」を一段下げて「agy が同じ状態制御モデルに 畳み込まれる、特別な仕組みなし」へ拡張したものです。

詳細：~/clikae-handoff-state-mapping.md。

§10 の残りは、その贈り物の上に積み上げたメンテナーの設計セッション（2026-06-01）です。 いまだ未踏領域であって、出荷された決定ではありません — ただ、形は合意されています。

10.1 統合：clikae はエンジンの頭脳の制御プレーン

上の緊張は、一つの考えに解けます。clikae はすでにエンジンの燃料がどこから来るか （どのアカウント／枠か）を制御しています。同じレバー — config ディレクトリへの ファイルシステム的な間接化 — が、エンジンのメモリも制御します。だからメモリも もう一つのダイヤルにすぎず、スペクトラムを成します。

agy のシンボリックリンクと同じプリミティブを、三つの目的に向けたもの。clikae の本質を 一言で：状態がどこに、どれだけの間、どれだけ広く共有されて存在するかを制御する — 認証／ 設定について（今日）、燃料について（捉え直し）、そしていまやメモリについて。

派生：MCP コネクタ。 各タンクに隔離された claude.ai のログインは、そのセッションで どの MCP コネクタが有効になるかも決めます — タンクを切り替えると、Stripe、Drive、 WordPress のコネクタも一緒に切り替わります。clikae は MCP を管理しないし、コネクタを プロビジョニングもしません。これは単に、アカウントごとの認証の隔離が、燃料とメモリに 並ぶ第三の層として実を結んだものです。

指針となる価値（メンテナー、確定）： 集約せよ、ソースを書き換えるな。 メモリの 移動／共有／変換は、外へ向かうコピーに対して行われ、ソース側のタンクのメモリはその場で 書き換えられることが決してありません。relay の「コピーであって移動ではない、ソースは 無傷」と同じ DNA です。

10.2 ブリッジ — プラグ可能でローカルファーストな翻訳器

エンジンをまたぐメモリはシンボリックリンクではありません：claude／codex／agy は 互換性のない形式でメモリを保管します。修正は handoff の既存の CLIKAE_HANDOFF_SUMMARIZER を写したもの — プラグ可能でローカル／安価なモデルが意味的な 仕事をこなし、clikae は配管を回すだけです。CLIKAE_MEMORY_TRANSLATOR='<cmd>' を 提案します：model-agnostic で、ローカルファースト（枠を燃やさず、何も機械から 出ない — メモリは機微なものだから）。Apple Intelligence はバックエンドの一つ （そのオンデバイスモデルは Swift の FoundationModels 経由でしか届かないので、小さな clikae-translate シムを介する — GUI はすでに Swift）。llm／ollama も別の一つ。

異議の焦点が形式から損失へ移ります。 一度きりの handoff ブリーフのための要約器が 安全なのは、ブリーフが使い捨てだからです。メモリはその正反対 — 権威があり、累積し、 セッションをまたいで信頼されます。LLM が同期のたびにメモリを書き直すと漂流します（伝言 ゲーム）。だからメモリの翻訳は、レビュー可能かつ可逆として扱われねばならず、黙ってバック グラウンドで書き直すものであってはなりません。

10.3 軽量か重量か — そしてアイデア B

• 軽量 — to ごとのメモリ注入（使い捨て）。 clikae to codex のとき、翻訳器は ソース側タンクのメモリの関連する一片を codex が使える形に変換し、handoff ブリーフと 並べて一度だけ注入する。codex は claude の頭脳を恒久的に育てるわけではない。この 続行に足るだけを知るだけ。正典のストアなし、伝言ゲームなし、並行性なし。文字どおり handoff ＋＋ ：ブリーフがスレッドを運び、これが頭脳の一片を運ぶ。まずこれをやる。
• 重量 — 恒久的な正典ストア。 clikae が唯一の正典メモリストアを保ち、翻訳器が 正典↔各エンジンを担い、すべてのツールが長期記憶を共有する。終着点だが、正典スキーマ、 レビュー可能な同期（差分を見せて、承認する）、漂流の制御、並行性の処理が要る。
• アイデア B（エンジンが clikae をネイティブに読み書きする） — 半分は本当、半分は壁。 すでに本当： clikae の config ディレクトリ間接化は、メモリを物理的にすでに自分の ツリーに置いている — まさにこのファイルの MEMORY.md が …/profiles/claude/b/…/memory/ 配下にある。壁： エンジンはメモリの場所のフック （環境変数）は公開するが、メモリの形式のフックは公開しない — claude のメモリを 移動はできても、clikae のスキーマで書かせたり、codex に claude のファイルを読ませたりは できない。だから B のきれいな形＝claude のほぼ中立な markdown を正典として採用する。 claude はほぼネイティブ、他は翻訳器でブリッジ。B は翻訳から逃れるのではなく、最も中立な 形式をアンカーに選ぶことで翻訳を最小化する。（B は別の扉から到達する重量版。）

10.4 一時的メモリ（「evaporate」モード） — ✅ 出荷済み

外科的なパワーユーザーは、何も覚えないモデルを望みます。clikae はすでに config ディレクトリの間接化を握っているので、memory サブディレクトリを使い捨てに向けるのは 造作もない — 同じプリミティブの三つ目の方向です。clikae <engine> <tank> --ephemeral と して出荷済み（lib/commands/switch.sh）：タンクの本物の projects/<slug>/memory を 脇へ退避し、その場所に mktemp -d の使い捨てをシンボリックリンクし、エンジンを子として （exec ではなく、なのでクリーンアップが走る）実行し、終了時に本物のメモリを復元して 使い捨てを消去します。クラッシュした実行は次の --ephemeral で自己回復します。ログインと トランスクリプトは通常どおり — メモリだけが使い捨てです。新しい任意フック adapter_memory_dir <dir> でエンジン側のゲートをかけます（claude が定義し、他は --ephemeral をきれいに拒否します）。bats は tests/bats/ephemeral.bats に。

正直な枠付け（書いたとおりに出荷）： clikae が保証するのはメモリディレクトリが 使い捨てであること — 一時的メモリであって、「どこにも何も覚えない」ではありません （キャッシュ、シェル履歴、テレメトリ、Keychain は手の届かない外側）。--help／ドキュメントは 保たれるものだけを約束します。

10.5 出荷の順序

1. ✅ 一時的メモリ — 出荷済み（--ephemeral；最小、モデル／翻訳ゼロ、外科的ユーザーに 即座の価値）。
2. to ごとの軽量メモリ注入 — ローカル翻訳器の試金石（handoff＋＋）。次。
3. 重量の正典ストア（＝アイデア B） — ローカルブリッジが信頼できると証明され、 使い捨ての一片だけでは足りないとわかってから。

三つとも一つの link/overlay 戦略（§10 冒頭）です — エンジンの頭脳に対するダイヤルとしての clikae。

この文法はスケッチではなく決定です。コードを変える前に、まずここで、メンテナーとともに 変えてください。