motsmanish/init

motspilot Init

Set up motspilot in the current project directory.

Steps

1. Run the init command:

   bash ${CLAUDE_PLUGIN_ROOT}/motspilot.sh --project=$(pwd) init
   

   This creates .motspilot/config with default values if it doesn't exist.

2. Read the generated .motspilot/config file.

3. Auto-detect project settings by scanning the project directory:

   • Language: check for composer.json (PHP), package.json (JS/TS), requirements.txt/pyproject.toml (Python), go.mod (Go), Gemfile (Ruby), pom.xml/build.gradle (Java)
   • Framework: check for config/app.php + CakePHP in composer.json (CakePHP), artisan (Laravel), manage.py (Django), next.config.* (Next.js), express in package.json (Express), etc.
   • Language version: read from composer.json require.php, .python-version, .nvmrc, go.mod, etc.
   • Test command: check for vendor/bin/phpunit, pytest, npm test, go test, etc.

4. Update .motspilot/config with detected values using Edit. Show the user what was detected and let them confirm or adjust.

5. Set up consensus (interactive — must block and wait):

   This step runs on EVERY /mots:init, including re-runs on an already-configured project. Do NOT short-circuit with "config is already configured, nothing to do" — the whole point of re-running /mots:init is usually that the user just added keys and wants consensus enabled. Always perform the checks below, always re-evaluate CONSENSUS, and always prompt via AskUserQuestion when keys are missing.

   Consensus has two modes (set via CONSENSUS_CLAUDE_MODE in .motspilot/config, default session):

   • session — Claude's three consensus roles (perspective, synthesis, differences) run via Task subagents using session quota. Only OPENAI_API_KEY and GEMINI_API_KEY are required. ANTHROPIC_API_KEY is optional. This is the default inside Claude Code.
   • api — bin/consensus.php calls the Anthropic API directly. All three keys are required.

   Check if consensus can run:

   • Run php --version — is PHP 8.0+ available?
   • Check process env for $ANTHROPIC_API_KEY, $OPENAI_API_KEY, $GEMINI_API_KEY.
   • If any key is missing from process env, also check whether it's defined in ~/.bashrc / ~/.zshrc / ~/.profile (using grep -lE 'export (ANTHROPIC|OPENAI|GEMINI)_API_KEY' ~/.bashrc ~/.zshrc ~/.profile 2>/dev/null). This distinguishes "user never set it" from "Claude Code stripped it."
   • Also check for a project-local file: .motspilot/.env in the current working directory.

   Required-key set depends on mode: in session mode, only OPENAI_API_KEY + GEMINI_API_KEY are required. In api mode, all three are required.

   Case A — PHP missing: Tell the user "Consensus requires PHP 8.0+ (not installed). Skipping — the pipeline works without it." Set CONSENSUS=disabled and move on.

   Case B — required keys resolvable (from env OR from .motspilot/.env): Tell the user "Consensus is ready (mode: session|api, keys detected from [source])." Set CONSENSUS=enabled and move on.

   Case C — Claude Code stripping detected (ANTHROPIC_API_KEY is in ~/.bashrc etc. but not in process env, while OpenAI/Gemini are present):

   In session mode this is not a problem — tell the user "Consensus is ready (mode: session). Your Anthropic key isn't needed here; Claude's consensus roles run through this Claude Code session." Set CONSENSUS=enabled and move on.

   If the user has explicitly set CONSENSUS_CLAUDE_MODE=api in config, continue with the existing flow: Claude Code strips ANTHROPIC_API_KEY from the session env when the user declines "use this key for your Claude Code session" at startup, and the project-local .env is the fix.

   Use AskUserQuestion to ask: "Your Anthropic key is in ~/.bashrc but Claude Code strips it from this session (by design, so it doesn't bill your API key for Claude Code itself). The standard fix is a project-local .motspilot/.env that consensus reads directly. Create one now?" Options:

   • Yes, I'll paste the keys into .motspilot/.env — print the instructions block below
   • Skip — keep consensus disabled

   If Yes, print this block verbatim:

   In your TERMINAL (not this chat — keys shouldn't touch the transcript), run:
   
     mkdir -p .motspilot
     cat > .motspilot/.env <<'EOF'
     ANTHROPIC_API_KEY=sk-ant-...
     OPENAI_API_KEY=sk-...
     GEMINI_API_KEY=...
     EOF
     chmod 600 .motspilot/.env
   
   Replace the three placeholder values with your real keys. Then:
     grep -qxF '.motspilot/.env' .gitignore 2>/dev/null || echo '.motspilot/.env' >> .gitignore
   
   Re-run /mots:init — consensus will read from the file and flip CONSENSUS=enabled.
   

   Set CONSENSUS=disabled in config for now.

   Case D — required keys simply absent (not in env, not in any rc file, no .motspilot/.env):

   The set of keys the user actually needs depends on mode. In the default session mode, only OPENAI_API_KEY and GEMINI_API_KEY are required.

   Use AskUserQuestion with options Yes, show me how to set the env vars / Skip for now.

   If Yes, print verbatim:

   Default mode (session) needs only OPENAI + GEMINI. Pick one:
   
   Option 1 (recommended) — per-project file, gitignored:
     mkdir -p .motspilot
     cat > .motspilot/.env <<'EOF'
     OPENAI_API_KEY=sk-...
     GEMINI_API_KEY=...
     # ANTHROPIC_API_KEY=sk-ant-...   # only if CONSENSUS_CLAUDE_MODE=api
     EOF
     chmod 600 .motspilot/.env
     grep -qxF '.motspilot/.env' .gitignore 2>/dev/null || echo '.motspilot/.env' >> .gitignore
   
   Option 2 — shell-wide env vars in ~/.bashrc:
     export OPENAI_API_KEY="sk-..."
     export GEMINI_API_KEY="..."
     # export ANTHROPIC_API_KEY="sk-ant-..."   # only if CONSENSUS_CLAUDE_MODE=api
   (Note: Claude Code strips ANTHROPIC_API_KEY from its own session unless
    you accept the startup "use this key" prompt. session mode avoids that.)
   
   Get keys:
     OpenAI:    https://platform.openai.com/api-keys
     Gemini:    https://aistudio.google.com/apikey
     Anthropic (api mode only): https://console.anthropic.com/settings/keys
   
   Re-run /mots:init once the file or exports are in place.
   

   Set CONSENSUS=disabled in config for now.

6. Show a summary:

   motspilot initialized for: <project name>
   Language: PHP 8.2
   Framework: Laravel (guide: prompts/frameworks/laravel.md)
   Test command: ./vendor/bin/phpunit
   Consensus: enabled (mode: session) / disabled (reason)
   
   Next: /mots:pilot <describe what to build>