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

issue is implementation work. pr is review work. They're different work types with different worker behavior.

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

tmux new -s project-dev

Or force a dedicated session (doesn't require tmux):

wtmag create --github 456 -t issue -s

WTmag uses gh to get issue and PR context:

gh auth status

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

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 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. WTmag won't guess flags.

The command parses:

wtmag create --jira PROJ-123

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

Promote a window to its own session:

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

Then attach as usual. The worker keeps running. It just gets its own tmux lifecycle.

wtmag list          # current project
wtmag list --all    # all projects

Or use tmux-sessionx (prefix + f) to fuzzy-find sessions and windows by name.