wt

wt - Worktree Manager Skill

git worktree を使用して、分離された LlamaFarm 開発環境を管理します。各 worktree は独自のサービス、ポート、データディレクトリを持つため、競合することなくエージェントセッションを並行して実行できます。

完全なドキュメント

完全なドキュメント、アーキテクチャの詳細、高度な使用方法については、以下を参照してください。 @scripts/wt/README.md

---

クイックリファレンス

タスク	コマンド
worktree を作成してサービスを起動する	wt create feat/my-feature
worktree を作成して移動する	wt create --go feat/my-feature
すべての worktree とステータスを一覧表示する	wt list
サービスのヘルスを確認する	wt status または wt health
サービスを起動／停止する	wt start / wt stop
サービスログを表示する	wt logs [server|rag|runtime|designer|all]
worktree を削除する	wt delete <name>
worktree に切り替える	wt switch <name>
ブラウザーで Designer を開く	wt open
問題を診断する	wt doctor
孤立したデータをクリーンアップする	wt gc

---

wt を使用する場面

次のような場合に wt を使用します。

• サービスの起動が必要な機能／タスクに、分離された環境で取り組む
• コーディングセッションを並行して実行する（複数のエージェントまたはターミナル）
• メインの開発環境に影響を与えずに変更をテストする
• LlamaFarm の複数インスタンスを同時に実行した際のポート競合を避ける

---

よく使うワークフロー

新しいタスクを開始する

# Create isolated environment with services running
wt create --go feat/my-task

# Work in the worktree...
# Services are already running on auto-assigned ports

# Check status anytime
wt status

# View logs if needed
wt logs server

実行中のものを確認する

# List all worktrees with their port assignments
wt list

# Example output:
# NAME              STATUS    SERVER   DESIGNER  RUNTIME
# feat-my-task      running   8150     5150      11150
# fix-bug           stopped   8234     5234      11234

クリーンアップする

# Stop services and remove a worktree
wt delete feat-my-task

# Remove data for worktrees that no longer exist
wt gc

# Remove worktrees for branches merged to main
wt prune

トラブルシューティング

# Diagnose common issues (ports, stale PIDs, missing tools)
wt doctor

# Restart stuck services
wt stop && wt start

# Force delete if normal delete fails
wt delete my-worktree --force

---

サービス URL

各 worktree には固有のポートが割り当てられます。次のコマンドで URL を確認します。

wt url
# Outputs:
#   Server:   http://localhost:8150
#   Designer: http://localhost:5150
#   Runtime:  http://localhost:11150

Caddy プロキシが実行中の場合は、ポートを指定しない URL を使用します。

http://server.feat-my-task.localhost
http://designer.feat-my-task.localhost

---

主な環境情報

• Worktree の場所：~/worktrees/llamafarm/
• データディレクトリ：~/.llamafarm/worktrees/<name>/
• ポートの割り当て：worktree 名の決定論的なハッシュ（14345+offset、5000+offset、11000+offset）
• ログ：~/.llamafarm/worktrees/<name>/logs/

---

エージェント向けの注意事項

1. 新しいタスク環境を設定する際は、必ず wt create --go を使用してください。ブランチ、依存関係、ビルド、サービスをすべて処理します。
2. 新しい worktree を作成する前に、まず wt list を実行してください。既存のものを確認できます。
3. テストの実行や API 呼び出しの前に、wt status を使用してください。サービスが正常であることを確認できます。
4. 原因不明のサービスの問題が発生した場合は、wt doctor を実行してください。
5. タスクが完了したら、wt delete でクリーンアップしてください。リソースを解放できます。