Troubleshooting

Forgot -t with --github

GitHub needs to know if it's an issue or a PR:

wtmag create --github 456 -t issue
wtmag create --github 456 -t pr

Window launch fails outside tmux

Defaults open workers as tmux windows. You need to be inside tmux:

tmux new -s project-dev

Or force a dedicated session:

wtmag create --github 456 -t issue -s

GitHub fetch fails

WTmag uses gh to get issue and PR context:

gh auth status

Make sure you're in the right repo and the number exists.

Agent won't start

WTmag launches whatever command is in your config. Check that it works on its own:

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

For custom agents, make sure command, args, and prompt_flag match the CLI's actual interface.

Model override fails

--model only works with Pi and OpenCode right now:

wtmag create --github 456 -t issue --agent opencode --model openai/gpt-5.2:high

For other agents, set the model in the agent's own config instead.

Jira doesn't work yet

The command parses:

wtmag create --jira PROJ-123

But the adapter isn't built. Use GitHub issues or custom prompts for now.

Worker needs more space

Promote a window to its own session:

wtmag promote --id project-github-issue-456

Then attach as usual.