droid-cli

Droid CLI ターゲット

オーケストレーターによってここに案内されました。すでに読み込んだドライバースキルに、このターゲット固有のパターンを重ねてください。

Droid 固有のショートカット、モード、起動パターンです。

ショートカット

アクション	キーの組み合わせ	結果
Spec モードの切り替え	shift tab	Spec モードのオン／オフを切り替えます
自律性レベルの切り替え	ctrl l	Off > Low > Med > High > Off の順に切り替えます
モデルの切り替え	ctrl n	利用可能なモデルを切り替えます
推論レベルの切り替え	tab	High > none > Low > Medium > High の順に切り替えます
キャンセル／閉じる／停止	esc	ストリーミングを停止し、オーバーレイを閉じます
入力のクリア	ctrl u	現在の行をクリアします
bash モードの切り替え	空の入力で !	プロンプトを > と $ の間で切り替えます
ヘルプ／ショートカット	?	キーバインドのヘルプを開きます
複数行入力	shift enter	送信せずに改行を挿入します

ダイアログ

ダイアログに Use up/down to navigate... と表示された場合、up／down でハイライトを移動し、enter で選択し、esc で閉じます。

スラッシュコマンド

コマンド	用途
/help	コマンドを表示します
/settings	設定メニューを開きます
/model	モデルセレクターを開きます
/clear または /new	新しいセッションを開始します
/sessions	過去のセッションを表示します
/status	現在の設定を表示します
/cost	使用状況／コストを表示します
/compress [prompt]	要約して新しいセッションに移行します

ファイルへのメンション

@ を入力するとファイル候補が開きます。入力して絞り込み、tab で確定し、esc でキャンセルします。

$TCTL -s demo type "review @"
$TCTL -s demo type "package.json"
$TCTL -s demo press tab

視覚的な手がかり

状態	確認する内容
Spec モードがオン	入力欄の枠に Spec と表示されます
bash モードがオン	プロンプトが $ です
アイドル／準備完了	スピナーがなく、プロンプトが > です
ダイアログが開いている	枠付きメニューとナビゲーションのヒントが表示されます
ファイル候補	入力欄の下にドロップダウンが表示されます
思考中	Thinking... と停止のヒントが表示されます

Droid の起動

droid-dev の動作

droid-dev は ~/.local/bin/droid-dev にある薄い bash シムです。DROID_DEV_REPO_ROOT が指すチェックアウトに対して bun を実行します。プリコンパイル済みバイナリは使用しません。つまり、次のとおりです。

• ブランチごとのビルドは不要です。 どのチェックアウトでも npm run setup を一度実行すればシムがインストールされます。--repo-root を使えば、ブランチをすぐに切り替えられます。
• 前提条件： 対象のワークツリーに node_modules がインストールされている必要があります（リポジトリのルートで npm install を実行します）。ない場合、bun の起動は失敗します。
• tctl --repo-root は DROID_DEV_REPO_ROOT を自動的に設定し、セッションをそのワークツリーに固定します。
• tctl --cwd は --repo-root とは独立しています。別のプロジェクトディレクトリにいる状態で、あるワークツリーのコードに対して droid を実行できます（たとえば、独自の .factory/settings.json フックを持つスクラッチプロジェクト）。指定されていない場合は、--repo-root がデフォルトになります。

droid-dev

droid-dev の起動には --repo-root（または --env DROID_DEV_REPO_ROOT=...）が必要です。tctl はこれを強制するため、指定なしで起動すると失敗します。

# tuistory (default — virtual PTY)
$TCTL launch "droid-dev" -s demo --backend tuistory \
  --repo-root /path/to/worktree \
  --cols 120 --rows 36

# true-input (real terminal proof — headless Wayland compositor)
$TCTL launch "droid-dev" -s demo --backend true-input \
  --repo-root /path/to/worktree

フィーチャーブランチ／ワークツリー

比較する場合は、異なるワークツリーを指定して別々のセッションを起動します。

$TCTL launch "droid-dev" -s before --backend tuistory \
  --repo-root /path/to/baseline-worktree \
  --cols 120 --rows 36 --record /tmp/before.cast \
  --env FORCE_COLOR=3 --env COLORTERM=truecolor

$TCTL launch "droid-dev" -s after --backend tuistory \
  --repo-root /path/to/candidate-worktree \
  --cols 120 --rows 36 --record /tmp/after.cast \
  --env FORCE_COLOR=3 --env COLORTERM=truecolor

比較のセットアップ（変更前／変更後のデモ）

変更前と変更後を比較するには、ベースライン用と候補用の2つのワークツリーパスが必要です。

1. 既存のワークツリーを確認する：任意のチェックアウトで git worktree list を実行します。メインのクローン（多くの場合、dev または main にあります）はベースラインとして使用できます。
2. 必要に応じて作成する：git worktree add /tmp/baseline-worktree dev（または該当するベースブランチ）を実行します。
3. node_modules を用意する：存在しないワークツリーで npm install を実行します。必要なセットアップはこれだけです。ブランチごとの npm run setup や CLI のビルドは不要です。
4. --repo-root を指定して起動する：各 tctl launch は1つのワークツリーに固定されます。

環境の安全性

tctl のランナースクリプトは bash -lc を介して droid-dev を起動し、クリーンなログインシェルを読み込みます。親プロセスから引き継がれた古い FACTORY_* 環境変数は、通常ランナーによって上書きされます。環境の汚染が疑われる場合は、--env で明示的に上書きしてください。

Exec モード

対話なしで一度だけ実行します。

droid exec "analyze this file"
droid exec --auto medium "run the tests"

ログ記録

--env でログファイルのパスを渡すと、デバッグログを有効にできます。

$TCTL launch "droid-dev" -s demo --backend tuistory \
  --repo-root /path/to/worktree \
  --env FACTORY_LOG_FILE=/tmp/droid-test.log
tail -f /tmp/droid-test.log