Commands
Every WTmag command and flag, grouped by what they do.
create
wtmag create --github 456 -t issue
wtmag create --github 234 -t pr
wtmag create --prompt "Do a thing"
wtmag create --jira PROJ-123Source flags
| Flag | What it does | Work type |
|---|---|---|
--github <number> | GitHub issue or PR number | Implementation or Review |
-t, --type issue/pr | Required with --github | issue → implementation, pr → review |
--jira <id> | Jira ticket ID (not implemented yet) | Implementation |
--prompt <text> | Custom prompt, or extra instructions on top of a source | Implementation |
--prompt by itself means a custom prompt task. --prompt with --github or --jira means "keep the source context and add these instructions." Don't use --prompt with a source unless you explicitly want extra instructions — the built-in prompts already contain the full delivery workflow.
Agent flags
| Flag | What it does |
|---|---|
--agent <name> | Override the default agent for this run |
--model provider/model[:thinking] | Override the model (Pi and OpenCode only) |
Placement flags
| Flag | What it does |
|---|---|
--launch session | Dedicated tmux session |
--launch window | Window in the current tmux session |
-s | Same as --launch session |
-w | Same as --launch window |
Windows require being inside tmux. Sessions don't.
Placement resolves in this order: CLI flag → project wtmag.toml → global ~/.config/wtmag/config.toml. Implementation and review work have separate config keys ([launch] implementation and [launch] review).
list
wtmag list # current project
wtmag list --all # all projectsShows known workers and whether they are running or stopped.
attach
wtmag attach project-github-issue-456Attaches to the worker's tmux session or parent-session window.
promote
wtmag promote --id project-github-issue-456Turns a window worker into a dedicated session. Useful when a task grows beyond a single pane.
cleanup
wtmag cleanup --id project-github-issue-456
wtmag cleanup --id project-github-issue-456 --forceRemoves the worktree and tmux target together. --force passes --force to wt remove for dirty worktrees.