WTmag Docs

WTmag is a CLI that creates a git worktree and a tmux session for a coding task, writes a brief, and starts your agent inside. You can attach to the worker whenever you want to watch or take over.

What it does

Give it a GitHub issue, a PR to review, or a plain prompt. WTmag will:

1. Fetch the task context (issue text, PR diff, or your prompt).
2. Create a worktree with WorkTrunk.
3. Write the full brief to .wtmag/prompt.md in that worktree.
4. Open a tmux session or window.
5. Start your agent inside with a short bootstrap prompt.

That's it. No cloud, no background daemon, no web UI. Just local processes you can see.

wtmag create --github 456 -t issue
wtmag create --github 234 -t pr
wtmag create --prompt "Refactor the auth middleware"

What works

• GitHub issues (implementation workers)
• GitHub PRs (review-only workers)
• Custom prompts
• Pi, OpenCode, Claude Code, Codex, or your own CLI
• Local worktrees and tmux workers

What doesn't work yet

• Jira adapter (the command exists but doesn't fetch anything)
• Cloud or remote runtimes

Start here

1. Install WTmag and its dependencies.
2. Create your first worker.
3. Read the guides for specific workflows.
4. Check the reference when you need exact syntax.