Slash Command

/octo-doctor

Runs environment diagnostics across 12 categories checking providers, auth, config, hooks, scheduler, and more. Produces summary table with pass/warn/fail counts and fix suggestions. Also supports category-specific checks.

Bash

Node

developer-tools

monitoring

Install

npx claudepluginhub nyldn/claude-octopus --plugin octo

Referenced Files

google/gemini-cliopenai/codex

Prompt Preview

# Doctor - Environment Diagnostics

**Your first output line MUST be:** `🐙 Octopus Doctor`

Run environment diagnostics across 12 check categories. Identifies misconfigured providers, stale state, broken hooks, missing dependencies, and other issues.

## Step 1: Run Full Diagnostics



## Step 2: Run Dependency Check



## Step 3: If dependencies are missing, install them



## Step 4: Filter by Category (Optional)

If the user asks about a specific area:



## Interpreting Results

| Issue | Fix |
|-------|-----|
| Codex CLI not found | `npm install -g @openai/codex` |
| Gemini CLI not fo...

Command Content

Stats

Stars2773

Forks264

Last CommitApr 9, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

environment-diagnostics

# Doctor - Environment Diagnostics **Your first output line MUST be:** `🐙 Octopus Doctor` Run environment diagnostics across 12 check categories. Identifies misconfigured providers, stale state, broken hooks, missing dependencies, and other issues. ## Step 1: Run Full Diagnostics ## Step 2: Run Dependency Check ## Step 3: If dependencies are missing, install them ## Step 4: Filter by Category (Optional) If the user asks about a specific area: ## Interpreting Results | Issue | Fix | |-------|-----| | Codex CLI not found | `npm install -g @openai/codex` | | Gemini CLI not fo...

Doctor - Environment Diagnostics

Your first output line MUST be: 🐙 Octopus Doctor

Run environment diagnostics across 12 check categories. Identifies misconfigured providers, stale state, broken hooks, missing dependencies, and other issues.

Step 1: Run Full Diagnostics

cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor --verbose

Step 2: Run Dependency Check

bash "${HOME}/.claude-octopus/plugin/scripts/install-deps.sh" check

Step 3: If dependencies are missing, install them

bash "${HOME}/.claude-octopus/plugin/scripts/install-deps.sh" install

Step 4: Filter by Category (Optional)

If the user asks about a specific area:

cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor providers cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor auth cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor config cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor hooks cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor scheduler cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor skills cd "${HOME}/.claude-octopus/plugin" && bash scripts/orchestrate.sh doctor agents

Interpreting Results

Issue

Fix

Codex CLI not found

npm install -g @openai/codex

Gemini CLI not found

npm install -g @google/gemini-cli

Auth expired

Re-run codex login or gemini

Legacy install detected

Remove old cache dir, reinstall plugin

Stale state

Delete .octo/state.json and re-initialize

Missing deps

Run install-deps.sh install

Present results as a summary table with pass/warn/fail counts.