# Getting Started Docs

For first-time setup and quick orientation.

## Start Path

1. Main overview and quick start: [../../README.md](../../README.md)
2. One-click setup and dual bootstrap mode: [one-click-bootstrap.md](one-click-bootstrap.md)
3. Install the Kumiho & Operator Python MCP sidecars: [kumiho-operator-setup.md](kumiho-operator-setup.md)
4. Update or uninstall on macOS: [macos-update-uninstall.md](macos-update-uninstall.md)
5. Dashboard local dev and build workflow: [dashboard-dev.md](dashboard-dev.md)
6. Find commands by tasks: [../reference/cli/commands-reference.md](../reference/cli/commands-reference.md)

## Choose Your Path

| Scenario | Command |
|----------|---------|
| I have an API key, want fastest setup | `construct onboard --api-key sk-... --provider openrouter` |
| I want guided prompts | `construct onboard` |
| Config exists, just fix channels | `construct onboard --channels-only` |
| Config exists, I intentionally want full overwrite | `construct onboard --force` |
| Using subscription auth | See [Subscription Auth](../../README.md#subscription-auth-openai-codex--claude-code) |

## Onboarding and Validation

- Quick onboarding: `construct onboard --api-key "sk-..." --provider openrouter`
- Guided onboarding: `construct onboard`
- Existing config protection: reruns require explicit confirmation (or `--force` in non-interactive flows)
- Ollama cloud models (`:cloud`) require a remote `api_url` and API key (for example `api_url = "https://ollama.com"`).
- Validate environment: `construct status` + `construct doctor`
- Dashboard dev/build loop: [dashboard-dev.md](dashboard-dev.md)

## Next

- Runtime operations: [../ops/README.md](../ops/README.md)
- Reference catalogs: [../reference/README.md](../reference/README.md)
- macOS lifecycle tasks: [macos-update-uninstall.md](macos-update-uninstall.md)
