From second-brain
Interactive onboarding for Second Brain — launches a local dashboard to configure profile and integrations in one click
How this skill is triggered — by the user, by Claude, or both
Slash command
/second-brain:setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Launches a local web dashboard at `localhost:3141` for one-click profile and integration setup.
Launches a local web dashboard at localhost:3141 for one-click profile and integration setup.
Data directory: ~/.second-brain/
python3 --version (or python --version on Windows)
brew install [email protected] or download from python.orgRun: python3 -c "import sys, platform; print(f'{platform.system()}|{sys.version_info.major}.{sys.version_info.minor}')"
Parse the output:
Darwin (macOS), Windows, or LinuxIf Python not found or <3.10, tell the user:
brew install [email protected] or download from https://python.org/downloads/"sudo apt install python3 or sudo dnf install python3"Stop setup until Python is available.
Read ~/.second-brain/config.json. If it exists and setup_complete is true, tell the user:
"Second Brain is already configured. Run /second-brain:setup --reset to reconfigure."
If $ARGUMENTS contains --reset, delete ~/.second-brain/config.json and proceed.
If $ARGUMENTS does NOT contain --text:
Launch the dashboard server:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/setup_dashboard/launch.py"
This will:
~/.second-brain/.venv/ if neededhttp://localhost:3141 in the user's browserTell the user:
Setup dashboard is opening in your browser at http://localhost:3141
Fill in your profile, connect your integrations, and click "Complete Setup".
The server will shut down automatically when you're done.
If the browser didn't open, visit http://localhost:3141 manually.
Wait for the server process to finish (it auto-exits after setup completes).
Verify setup succeeded by reading ~/.second-brain/config.json and checking setup_complete is true.
Print completion message:
Second Brain setup complete!
Your vault: ~/.second-brain/vault/
Your config: ~/.second-brain/config.json
What's running:
- SessionStart hook: loads memory into every conversation (automatic)
- Stop hook: auto-logs decisions and action items (automatic)
- Background services: heartbeat, indexer, reflection (if installed)
Next steps:
- Open ~/.second-brain/vault/ in Obsidian for graph view
- Try: /second-brain:status
- Try: "show me my open PRs"
- Try: "what's on my calendar today?"
- Just work normally — decisions and action items are auto-logged
If $ARGUMENTS contains --text, OR if the dashboard fails to launch, fall back to the interactive text wizard:
Step 2t: Gather user profile
Ask the user (one question at a time):
Step 3t: Select integrations
Ask: Which integrations do you want to connect? (select all that apply)
Step 4t: Configure each selected integration
For Gmail + Google Calendar:
~/.second-brain/data/credentials/gmail/credentials.json"Use the list_emails` MCP toolFor GitHub:
~/.second-brain/.env as GITHUB_TOKEN=<token>Use the github_rate_limit` MCP toolFor Asana:
~/.second-brain/.env as ASANA_TOKEN=<token>Use the list_asana_projects` MCP toolStep 5t: Configure Claude API
Ask: "How do you access Claude?"
Save to ~/.second-brain/.env.
Step 6t: Create vault + finish
Create vault structure, install deps, index, save config — same as dashboard's "Complete Setup" flow.
Run:
python3 -c "
import sys; sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/scripts')
from config import ensure_dirs, save_config
ensure_dirs()
"
Step 7: Deploy Organization & Product Context (automatic)
Copy the pre-filled ORG.md and PRODUCTS.md from plugin templates to the vault. These contain the organization's company profile and full product registry — no user input needed.
# Copy org and product files if they don't already exist in vault
for file in ORG.md PRODUCTS.md; do
if [ ! -f ~/.second-brain/vault/$file ]; then
cp "${CLAUDE_PLUGIN_ROOT}/templates/$file" ~/.second-brain/vault/$file
echo "Deployed $file to vault"
fi
done
This ensures every team member who installs the plugin automatically gets:
These files are injected into every session and every skill has access to this context.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub viditparashar96/second-brain-claude --plugin second-brain