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.Smart router - Single entry point with natural language intent detection
Backend architect. Delegate only when the user explicitly starts an Octopus workflow.
Start a creative thought partner brainstorming session
Switch Octopus model routing to the configured budget tier
[advanced] Activate destructive command warnings for the session
[advanced] OpenClaw instance administration — manage hosts across macOS, Ubuntu/Debian, Docker, OCI, and Proxmox
Cloud architect. Delegate only when the user explicitly starts an Octopus workflow.
Code reviewer. Delegate only when the user explicitly starts an Octopus workflow.