# shelbi wizard

Run the same detected, one-confirmation project setup used by first-run Shelbi.

```text
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:

```text
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:

```bash
cd ~/code/myapp
shelbi wizard
```

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

```bash
shelbi init -y --runner codex
```

## See also

- [Set up your first project](/docs/guides/getting-started/first-project) for
  every happy-path and edge-path screen.
- [`shelbi init`](/docs/cli/init) for scriptable setup and config pick-up.
- [`shelbi project`](/docs/cli/project) for additional projects.