shelbi wizard

shelbi wizard

shelbi wizard is the explicit interactive entry point for Shelbi's first project setup. It inspects the current Git checkout and machine, prints the preflight results, and presents one setup card:

Enter launch    c customize    q quit

Press Enter to create the detected plan and launch the dashboard. Press c to edit the prefilled project, repository, branch, remote, runner, workspace, and orchestrator values. Press q, Esc, or Ctrl+C to leave without project state.

If both Claude Code and Codex are detected, the wizard first asks Which agent?. If the current directory is not a Git repository, it first asks permission to run git init -b main. Missing tmux or runner prerequisites stop setup before the card and print an install-and-retry message.

The command is idempotent at the project-registration level. If any project is already registered, it completes without creating another one. Use shelbi project add to run the shared setup flow for an additional project.

Examples

Run setup explicitly from the repository you want Shelbi to manage:

cd ~/code/myapp
shelbi wizard

For automation, use the non-interactive detected-plan path instead:

shelbi init -y --runner codex

See also

• Set up your first project for every happy-path and edge-path screen.
• shelbi init for scriptable setup and config pick-up.
• shelbi project for additional projects.