← ClaudeAtlas

wtxlisted

Use the `wtx` CLI to give each git worktree a microVM with a dedicated in-VM dockerd, DBs, ports, images, and optional host iOS simulator. Use for parallel coding agents, Orca/Herdr worktree runtime integration, fresh-worktree bootstrap, `.env.example` fallback, `wtx up --from` environment seeding, golden VMs, registry mirrors, release update checks, "worktreeごとにVM/DB", "VM内でdocker", or worktree-specific simulators. The worktree and Git metadata are host-shared, but credentials stay on the host unless --agent-access is explicitly requested. wtx is not a security sandbox. Use orca-cli for Orca-owned worktrees and terminals; use plain git worktrees when no isolated VM or Docker runtime is needed.
rakutek/wtx · ★ 0 · Code & Development · score 62
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