Slash Command3.6k repo starsupdated yesterday

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.

View source Repository: claude-octopus

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.

Definition

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:-$(git -C "$(pwd)" rev-parse --show-toplevel 2>/dev/null || echo "${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`

Run `/octo:setup` to install or configure any missing provider.