Setup wizard

The setup wizard appears when a project folder is not ready to run yet. It collects the minimum project identity and provider information Guildhall needs before it can create tasks or start work.

Steps

1. Identity — project name and slug. The slug becomes the project id used by the browser UI and CLI.
2. Provider detection — GET /api/setup/providers checks the built-in provider paths Guildhall knows about today: Claude OAuth, Codex OAuth, Anthropic-compatible API credentials, OpenAI-compatible API credentials, and the configured local OpenAI-compatible server path. Detected providers light up; undetected ones show an inline configuration prompt.
3. Credentials — for hosted providers, either paste an API key or log in via the provider's CLI. API keys land in ~/.guildhall/providers.yaml, while Claude and Codex OAuth stay in their own CLI auth stores. Guildhall's default provider choice is machine-wide in ~/.guildhall/config.yaml, with an optional project-local override in ./.guildhall/config.yaml only when one project truly needs different behavior.
4. Launch — choose between "bootstrap via meta-intake" (recommended) or "skip to the project shell." Meta-intake drafts coordinators, verified bootstrap commands, and inferred lever positions for approval.

Re-running

guildhall config re-opens the wizard on an existing project so you can reconfigure providers, change models, or rerun meta-intake without losing state.