Installation

WTmag is a thin CLI over tools you probably already have. If you live in the terminal, most of this is already done.

What you need

Go to install WTmag
Git
WorkTrunk for worktree management
tmux where workers run
A coding agent CLI — Pi, OpenCode, Claude Code, Codex, or your own
GitHub CLI if you pull from GitHub Issues or PRs
tmux-sessionx — recommended for fuzzy-finding and jumping into workers fast

Install WTmag

go install github.com/obiMadu/wtmag@latest

Check it works:

wtmag --help

Set up your repo

WTmag works with a WorkTrunk-managed repo. Bare clone, then check out the default branch:

git clone --bare <repo-url> project/.git
cd project
wt switch ^

^ is WorkTrunk shorthand for the default branch — usually dev or main.

Run WTmag from inside a worktree, not the bare .git dir.

Make sure your tools work

WTmag doesn't handle auth for your agent. Each agent authenticates through its own native flow, so make sure it works from a normal shell before WTmag launches it.

gh auth status
tmux -V
wt --help

Then check whichever agent you want to use:

pi --help
opencode --help
claude --help
codex --help

You only need one agent to start. The default is Pi.

Load the orchestrator skill

The WTmag skill is what turns your agent into an orchestrator. It tells the agent how to understand your intent and dispatch workers. Load it when you start your orchestrator session:

tmux new -s project-dev
pi --skill ./skill

The skill file lives in the WTmag repo at skill/SKILL.md. You can also install it globally:

mkdir -p ~/.config/opencode/skills/wtmag
curl -fsSL https://raw.githubusercontent.com/obiMadu/wtmag/main/skill/SKILL.md \
  -o ~/.config/opencode/skills/wtmag/SKILL.md

First-run config

On first run, WTmag creates ~/.config/wtmag/config.toml with sensible defaults:

[agents.default]
name = "pi"

[launch]
implementation = "window"
review = "window"

Override globally in ~/.config/wtmag/config.toml or per project in wtmag.toml at your repo root. Project config layers on top of global. See configuration for the full schema.