Skip to main content
ClaudeWave
Slash Command3.9k repo starsupdated today

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.

Install in Claude Code
Copy
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/nyldn/claude-octopus/HEAD/.claude/commands/preflight.md -o ~/.claude/commands/preflight.md
Then start a new Claude Code session; the slash command loads automatically.

preflight.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.