WTmag Docs
WTmag is conversational task-to-PR orchestration for terminal-native engineers. Talk through work with your orchestrator, dispatch parallel AI workers, stay close to the work.
WTmag is a local agent orchestration CLI built for engineers who live in the terminal. You start with a conversation: talk through what needs doing with your orchestrator agent, shape a rough idea into a brief, pull an existing ticket from wherever your team tracks work, or point it at something open for review. The orchestrator turns that conversation into parallel dispatch: each task gets its own isolated git worktree, its own tmux session, and its own running agent.
The design is built around a two-tier model. Your orchestrator runs in your main tmux session, the one you're already in. Workers run in separate worktrees and tmux windows. You can jump into any of them at any point, read the conversation, run commands in a split pane, or take over and finish the work yourself. It's just tmux.
The shape of it
wtmag create --github 456 -t issue
wtmag create --github 234 -t pr
wtmag create --prompt "Refactor the auth middleware"WTmag fetches the full task context, creates a worktree with WorkTrunk, writes the brief to .wtmag/prompt.md, opens a tmux session or window, and starts your agent inside with a short bootstrap: read that file. The worker runs in the background. You attach when you want to.
No cloud, no daemon, no web UI. Just local processes you can see and touch.
What works today
- GitHub issues: workers implement, commit, push, and open a PR
- GitHub PRs: workers review and report back, read-only
- Custom prompts: workers do whatever you told them
- Pi, OpenCode, Claude Code, Codex, or any custom agent CLI
- Local worktrees and tmux workers
What's not done yet
- Jira adapter (the command parses but nothing fetches)
- Cloud or remote runtimes (Daytona sandboxes, etc.)
The task source system is open by design. GitHub Issues ship built-in, and the architecture is meant to grow: Linear, Asana, GitLab Issues, or any platform you track work in. Same principle on the agent side: the four built-in agents can be extended with any CLI you define.
Where to go next
- Start with the overview to see how a real session flows.
- Install WTmag and its dependencies.
- Create your first worker.
- Understand the concepts: the two-tier model, the skill, worktrees, agents, and tasks.
- Check the reference when you need exact syntax.