Available commands
| Command | Alias | Description |
|---|---|---|
/init | /i | Scan project and configure AI provider |
/new <name> | /n | Create a feature spec via AI interview |
/run <name> | /r | Start the autonomous Ralph loop |
/monitor <name> | /m | Monitor a running feature loop |
/issue | Browse GitHub issues in a columnar picker | |
/sync | /s | Re-scan project and update context |
/config [args] | Manage API keys and settings | |
/help | /h | Show available commands |
/exit | /q | Exit wiggum |
Screens
Main shell
The default screen is a command shell with/ prefix commands. Features:
- Slash command autocomplete — Type
/and see suggestions - Spec name autocomplete — Tab-complete spec names for
/run - Background run tracking — See active loops in the header
- Context age indicator — Shows when your codebase context was last updated
Init screen
Launched by/init. Walks through six phases with progress tracking:
- Scanning (tech stack detection)
- Provider selection
- API key input
- Model selection
- AI analysis (agentic codebase enrichment)
- File generation
Interview screen
Launched by/new <name>. The AI interview has five phases:
Context
Add reference URLs, files, or GitHub issues. Use the built-in issue picker to browse and select issues visually.
Interview
The AI asks up to 10 clarifying questions. Each question comes with structured answer options you can select, or type a custom answer. The AI uses codebase tools (file reading, pattern search, directory exploration) to ask project-specific questions.Say “done” at any point to skip remaining questions.
Run screen
Launched by/run <name>. Shows live progress while the Ralph loop executes:
- Phase progress bars — Each phase (planning, implementation, E2E testing, verification, PR review) shows status with duration
- Iteration counter — Current iteration out of max (e.g.
3/10) - Activity feed — Real-time stream of coding agent actions
- Token tracking — Input/output token counts and cache metrics
- Task checklist — Implementation plan tasks with completion status
- Git branch info — Current branch and commit count
/monitor <name>.
Completion summary: When done, shows phase durations, final iteration count, file changes, commit history, and PR link.
Agent screen
Launched bywiggum agent (not available as a TUI command — run from the CLI). Shows the autonomous orchestrator in action:
- Backlog ranking and issue selection with reasoning
- Real-time loop progress for the current issue
- Completion outcomes for each processed issue
Issue picker
Launched by/issue or automatically during /new when using --issue. Shows a columnar table of GitHub issues with title, labels, and status. Select an issue to pre-load its context into the spec interview.
Keyboard shortcuts
| Key | Action |
|---|---|
| Esc | Cancel current operation / background running loop |
| Tab | Autocomplete command or spec name |
| Enter | Submit command or answer |
| Ctrl+C | Exit wiggum |