Onboarding Wizard
The wizard opens automatically on first install. Six steps.
What each step does
Section titled “What each step does”1. Welcome — one screen, click Continue.
2. Provider setup — pick a provider and paste the API key, then click Test to verify it (the wizard makes a short test call). Providers without a verification endpoint fail closed rather than pass silently. You don’t have to add a key here: Skip setup proceeds with no provider configured — you can add one later from an in-chat banner or the in-chat model picker (the keyless on-ramp).
3. Web search (optional) — add one web-search key (Tavily, Brave, or Firecrawl) to enable the web_search tool. Skippable.
4. Workspace detection — scans the open folder for language, framework, git, Docker, and package manager. Results become part of the agent’s project context.
5. Security profile — sets the default permission profile (restricted / standard / trusted). Standard is the sensible default; change later in settings.
6. First task — suggests a task tailored to the detected project type (“Analyze my codebase architecture”, “Help me set up the project structure”).
Re-running
Section titled “Re-running”CodeBuddy: Show Onboarding WizardCompletion state lives in the editor’s global storage under a version number. Bumping the wizard version in a release auto-reopens it to cover new setup steps.
What detection actually looks at
Section titled “What detection actually looks at”Language — indicator files:
| Language | Trigger |
|---|---|
| TypeScript | tsconfig.json, .ts |
| JavaScript | package.json, .js, .mjs |
| Python | requirements.txt, pyproject.toml, setup.py, .py |
| Java | pom.xml, build.gradle, .java |
| Go | go.mod, .go |
| Rust | Cargo.toml, .rs |
| PHP | composer.json, .php |
| Ruby | Gemfile, .rb |
| C# | .csproj, .sln, .cs |
| Swift | Package.swift, .swift |
Framework — top-level dependency in package.json (React, Next.js, Vue, Angular, Express, NestJS) or requirements.txt (FastAPI, Django, Flask).
Rest — presence of .git/, Dockerfile / docker-compose.yml, and lockfile shape (npm / yarn / pnpm / pip / poetry).
If detection guesses wrong, re-run the wizard (CodeBuddy: Show Onboarding Wizard) or re-index with CodeBuddy: Index Workspace for Semantic Search.