wtxlisted
Install: claude install-skill rakutek/wtx
# wtx
git worktree × コーディングエージェントの並列開発のための CLI/TUI。worktree ごとに
独立したVM(Lima vz microVM)+VM内専用 dockerd を与えるので、各ブランチが自分の
DB・ポート・イメージを持ち、複数エージェントを同時に走らせても衝突しない。
ホストと同じ絶対パスで worktree をマウントするので、ホスト側での直接編集はそのまま使える。
VM内にはversion固定のdocker(rootful)とgitが入る。agent固有CLIはglobal installしない。
worktreeとgit metadataはホストと共有され、VM内コミットは即ホストのブランチに乗る。
`~/.claude`とssh-agentは既定で共有せず、信頼できるVM内agentで必要な場合だけ
`--agent-access`を指定する。wtxは**セキュリティサンドボックスではない**。
agent・編集・Git・資格情報はhost、Docker/DB/serviceだけVMへ送るのが標準形。
コマンドやフラグを暗記や推測で書かないこと。実行前に `wtx --help` /
`wtx <cmd> --help` で確認する。`image`と`mirror`も型付きsubcommandとしてhelpに列挙される。
## セットアップ(初回のみ)
```bash
brew install lima
cargo build --release # リポジトリ: https://github.com/rakutek/wtx
wtx mirror install # 任意: レジストリキャッシュ(launchdオンデマンド、常駐なし)
wtx image build # ゴールデンVM構築(3〜4分)
```
ゴールデンVMがあると以後の `wtx up` は `limactl clone` で約8秒。無い・古い場合は
別環境へ黙ってfallbackせず失敗する。fresh構築が必要なら`--no-clone`を明示する。
## 基本フロー
```bash
wtx new BRANCH # worktree + VM を一発で作成(repo内から実行。ブランチが無ければ作る)
wtx new BRANCH --from NAME # 既存VMからDB(volume)・イメージごと引き継いで作成
wtx up # worktree内で引数なし: そのworktreeのVMを解決して作成/��動
wtx up NAME ~/repos/worktree-dir # 明示形(worktree自動判別、gitはホストと共有)
wtx ensure NAME ~/repos/worktree-dir --json # 冪等に作成/起動し、dockerd ready receiptを返す
wtx inspect NAME --json # runtime・worktree・owner・port・sim状態
wtx exec -- docker compose up -d --wait # worktree内ではNAME/-w不要
wtx exe