/setup-gaia

/setup-gaia is the per-machine setup for a cloned GAIA project. The creator of the project ran /gaia-init, but the per-machine state (Claude plugins, etc.) does not travel in git. Every developer who clones the repo needs to run /setup-gaia once.

When to use this

• After git clone-ing an existing GAIA project
• Do not use after running npx create-gaia.

The flow

Pre-step: pnpm and node_modules

If corepack is available, pnpm is enabled at the version pinned in package.json. Otherwise pnpm is installed globally via npm. If node_modules/ is missing, pnpm install runs.

1. install-tools

Three external tools, identical to step 4 of /gaia-init:

• React Doctor skill
• Playwright CLI binary
• Serena MCP server (with uv bootstrapped if missing)

If Serena is already registered, the installer treats the “name already exists” error as success and continues.

2. install-plugins

claude plugin install typescript-lsp@claude-plugins-official
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@claude-obsidian-marketplace

Already-installed plugins are no-ops.

4. Mentorship opt-in

You can choose to opt-in to GAIA’s experimental mentorship feature.

Resuming after a failure

If you encounter any issues while /setup-gaia runs, ask Claude to fix it and resume.