preflight
The preflight command executes a health check script that verifies all configured AI providers are operational and accessible before running multi-LLM workflows. Use this command before launching complex Octopus operations like embrace, research, or council to identify connectivity or authentication issues with Ollama, OpenAI Codex, or Google Gemini and prevent workflow failures mid-execution.
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/nyldn/claude-octopus/HEAD/.claude/commands/preflight.md -o ~/.claude/commands/preflight.mdpreflight.md
# Octopus Provider Health Check
Run a quick health check on all configured AI providers before starting a workflow.
```bash
OCTO_ROOT="${OCTO_ROOT:-${CLAUDE_PLUGIN_ROOT:-${HOME}/.claude-octopus/plugin}}"
bash "${OCTO_ROOT}/scripts/helpers/preflight.sh"
```
Use this before `/octo:embrace`, `/octo:research`, or `/octo:council` to confirm your providers are available and avoid mid-workflow surprises.
**Common issues:**
- `Ollama` shows unavailable → start it with `ollama serve`
- `Codex CLI` unavailable → run `codex login` or `npm install -g @openai/codex`
- `Gemini CLI` unavailable → run `gemini auth login` or `npm install -g @google/gemini-cli`
- `Antigravity CLI` unavailable → verify `agy` is on PATH, then run `agy login` or reinstall Antigravity CLI
Run `/octo:setup` to install or configure any missing provider.Backend architect. Delegate only when the user explicitly starts an Octopus workflow.
Cloud architect. Delegate only when the user explicitly starts an Octopus workflow.
Code reviewer. Delegate only when the user explicitly starts an Octopus workflow.
Database architect. Delegate only when the user explicitly starts an Octopus workflow.
Debugger. Delegate only when the user explicitly starts an Octopus workflow.
Documentation architect. Delegate only when the user explicitly starts an Octopus workflow.
Frontend developer. Delegate only when the user explicitly starts an Octopus workflow.
Performance engineer. Delegate only when the user explicitly starts an Octopus workflow.