Skip to content
Automation
Command

/preflight

Check provider health before running multi-LLM workflows

From plugin
octo
4.1k53 skills49 agents53 commands18 hooks
Install
> /plugin marketplace add nyldn/claude-octopus

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/preflight

Context preview

What this command does when you run it.

Check provider health before running multi-LLM workflows

Command definition

preflight.md
command: preflight
disable-model-invocation: true
description: Check provider health before running multi-LLM workflows
allowed-tools: Bash

Octopus Provider Readiness

Show the shared readiness result for every registered provider. The default is a local-only static check: installation, safe configuration metadata, and known quota state. It does not contact provider services.

OCTO_ROOT="${OCTO_ROOT:-${CLAUDE_PLUGIN_ROOT:-${HOME}/.claude-octopus/plugin}}"
bash "${OCTO_ROOT}/scripts/helpers/preflight.sh"

When the user explicitly asks to verify live provider health, run the bounded live form:

bash "${OCTO_ROOT}/scripts/helpers/preflight.sh" --live

Both modes consume the Provider Registry 2.0 readiness contract. Do not run separate binary, authentication, model, quota, or network checks while rendering the result. Use `reason_code` and `remediation` from the shared objects when explaining a provider that needs attention.

Use this before `/octo:embrace`, `/octo:research`, or `/octo:council` to confirm provider readiness and avoid mid-workflow surprises.

**Common issues:**

  • `Ollama` requests a live check → rerun with `--live`; start it with `ollama serve` if the server is stopped
  • `Codex CLI` unavailable → run `codex login` or `npm install -g @openai/codex`
  • `Antigravity CLI` unavailable → verify `agy` is on PATH, then launch plain `agy` and complete its browser sign-in or reinstall Antigravity CLI

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

Read more
Ships withocto

Every AI model has blind spots. Claude Octopus supports twelve external provider integrations — Codex, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, Cursor CLI, Grok, and Kimi Code — alongside the built-in Claude Code

Get the whole plugin

Other commands on octo.