Verify Your Setup

• Time required: 5–10 minutes 

• What this does: Confirms every tool is installed, authenticated, and connected correctly. 

• When to use:After initial setup, and whenever something feels broken.

• What you will have after this: Confidence that every tool is connected and working correctly.

The verification sequence

Run each of these commands in order. After each one, check that the result matches what is listed under "Expected result." If any step fails, see Troubleshooting.

Check 1: Claude Code installation

claude /doctor

Expected result: All checks pass with no errors.

Check 2: Claude Code authentication and model

claude --print-model

Expected result: Shows your configured model (e.g., opusplanor claude-sonnet-4-20250514).

Now open Claude Code interactively:

claude

Type:

/status

Expected result: Shows your account, current model, and context window info. No errors.

Check 3: MCP servers are connected

While still in Claude Code, type:

/mcp

Expected result: You should see at minimum:

• context7 — connected/green

• beads-mcp — connected/green

• GitHub — connected/green

If any server shows disconnected/red, see troubleshooting.

Check 4: Beads hooks are installed

Exit Claude Code (/exit), then run:

bd setup claude --check

Expected result: All checks pass. Specifically confirms:

• SessionStart hook is installed

• PreCompact hook is installed

Check 5: Beads CLI works

bd version
bd status

Expected result: Version number prints. Status may show "no active project" which is fine — we have not created one yet.

Check 6: Plugins and skills are loaded

Open Claude Code:

claude

Type:

/plugin list

Expected result: You should see entries for:

• VoltAgent/awesome-claude-code-subagents

• nextlevelbuilder/ui-ux-pro-max-skill

• superpowers (may display as "obra/superpowers" or "superpowers@superpowers-marketplace" depending on version -- either is correct)

If any plugin is missing, re-run the install commands from Part 2.

Check 7: Context7 responds to queries

While still in Claude Code, type:

Use context7 to look up the latest React documentation for useState

Expected result: Claude should use the Context7 MCP server to fetch live React docs and give you an answer based on current documentation. You should see tool calls to resolve-library-id and/or query-docs in the output.

Check 8: Claude in Chrome (if installed)

1. Open Google Chrome

2. Click the Claude extension icon in the toolbar

3. It should show as signed in and ready

Expected result: The side panel opens and Claude is responsive.

Check 9: Git is configured

git config --global user.name
git config --global user.email

Expected result: Your name and email are printed. These will be used for all git commits.

Verification complete

If all 9 checks passed (or 8 if you skipped Claude in Chrome), your machine is ready.

Ready to start a project? Open Project Kickoff.