worktree-task-launcher
/worktree-task-launcher
Uruchamia zadanie FX Workbench w osobnym worktree i oknie tmux z interaktywnym agentem fx.
- Autor
- jarneson ↗
- Repozytorium
- fx-workbench ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 31.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 31.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Uruchamia zadanie FX Workbench w osobnym worktree i oknie tmux z interaktywnym agentem fx.
Oryginalny opis (EN)
Launch a canonical FX Workbench task in its own Git worktree and tmux window with an interactive fx agent. Use when asked to fork, launch, delegate, or start a task from a durable packet.
Jak działa
- Inputs
- Preflight and launch
- Safety and handoff
Podgląd SKILL.md
---
name: worktree-task-launcher
description: Launch a canonical FX Workbench task in its own Git worktree and tmux window with an interactive fx agent. Use when asked to fork, launch, delegate, or start a task from a durable packet.
---
# Worktree task launcher
Launch one canonical task packet through FX Workbench. The command owns branch, worktree, tmux, dependency, and prompt delivery decisions; do not recreate those steps in shell glue.
## Inputs
Resolve these before launching:
- A canonical task packet, located by stable task ID.
- The project when the task ID is not globally unambiguous.
- An optional branch override when the user does not want the branch stored in the packet.
If the request is only an informal description, use the `obsidian-planner` workflow to create a self-contained task packet first. Do not launch from chat-only context.
## Preflight and launch
Read the packet and inspect the target repository before launching. Confirm its repository, branch, assumptions, and current status are still correct. Never reset, delete, or reuse a dirty worktree to make preflight pass.
Run the non-mutating preflight first:
```bash
fx-workbench launch --dry-run [--project <project>] [--branch <branch>] <task-id>
```
If the plan is correct, launch through the same command:
```bash
fx-workbench launch [--project <project>] [--branch <branch>] <task-id>
```
Workbench then:
1. Resolves the canonical packet, repository, branch, worktree, workstream session, and coding profile.
2. Requires the main checkout to be clean, fetches `origin/main`, fast-forwards local `main`, and verifies equality.
3. Creates a new linked worktree under `${FX_TASK_WORKTREE_ROOT:-$HOME/dev/worktrees}`.
4. Starts dependency installation and the task fx agent concurrently.
5. Creates a task window in the workstream's tmux session and waits for the fx lifecycle bridge to become ready.
6. Sends the coding profile, complete task packet, and worker guidance as one prompt.
7. Records dependency completion or failure on the task pane and reports any partial resources if launch fails.
Repositories without `package.json` skip dependency installation. JavaScript repositories use the pinned `packageManager`, or `npm install` when it is absent. `FX_TASK_INSTALL_COMMAND` overrides automatic installation for repositories with another setup command.
## Safety and handoff
- Treat branch, worktree, task-window, and session identity conflicts as blockers. Do not delete or repurpose existing resources automatically.
- The launched agent works only in the new task worktree and must not create another branch or worktree.
- The launched agent must not commit, push, or open a pull request unless the user explicitly requests it.
- Wait for `tmux show-options -p -v @fx_install_state` to report `complete` before dependency-sensitive commands. If it reports `failed`, diagnose that installation before continuing.
- Keep the task packet as durable coordination state and update status through `fx-workbench status`.
Wersje
W bazie nie ma innych skilli o nazwie worktree-task-launcher.
Migawka bazy z 13.11.2026 · wersja paczki b0401abe2556 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95tmux-start
Startuje pracę nad zgłoszeniem w nowym oknie tmux z osobnym worktree, gdy użytkownik działa w sesji tmux. - 96tmux
Steruje sesją tmux i interaktywnym terminalem, gdy zadanie w linii poleceń wymaga stałego okna. - 100internal-dev-workbench
Uruchamia sesję deweloperską portless i tmux dla Workflow SDK z izolowanymi adresami .localhost dla każdego worktree git oraz linią statusu Claude. - 100worktree-new
Tworzy worktree zadania poleceniem aidrian i uruchamia bootstrap projektu. - 100session
Zarządza sesjami i drzewami roboczymi Git oraz sesjami tmux: tworzy nowe sesje i porządkuje worktree. - 100using-git-worktrees
Zarządza git worktree z integracją tmux i dyspozycją zadań: tworzenie izolowanych środowisk w .claude/worktrees/, równoległe prace nad funkcjami, wiele instancji Claude, okna tmux i sprzątanie po merge.