Skip to main content

​
Syntax

scoutica doctor
The doctor command takes no arguments or flags.

​
Usage example

scoutica doctor

​
What it checks

scoutica doctor runs a series of system checks and reports the result of each one. Checks are divided into required (errors if missing) and optional (warnings if missing).

​
Required checks

CheckWhat is verified
CLI installation~/.scoutica/bin/scoutica exists and is executable
PATHscoutica is reachable as a command
Templates~/.scoutica/templates/rules/ directory exists with .md rule files
Schemas~/.scoutica/schemas/ directory exists with .json schema files
Python 3python3 is installed and accessible in PATH
Gitgit is installed and accessible in PATH

​
Optional checks

CheckWhat is verified
pdftotextpoppler-utils is installed for PDF text extraction

​
AI provider checks

The doctor command also checks for each supported AI provider CLI:
ProviderCLI
Gemini CLIgemini
Claude Codeclaude
OpenAI Codexcodex
Mistral Vibevibe
OpenCodeopencode
Ollamaollama
switchAILocalail
At least one provider must be installed to use scoutica scan without --clipboard.

​
Expected output

  ✅ CLI installed at /Users/you/.scoutica/bin/scoutica
  ✅ scoutica found in PATH
  ✅ Templates present (4 rule files + card.gitignore)
  ✅ Schemas present (3 JSON schemas)
  ✅ Python 3.12.0
  ✅ git version 2.43.0
  ⚠️  pdftotext not found (optional — install poppler-utils for better PDF support)

AI Providers:
  ✅ gemini (installed)
  ❌ claude (not found)
  ❌ codex (not found)
  ❌ vibe (not found)
  ❌ opencode (not found)
  ❌ ollama (not found)
  ❌ ail (not found)

  Result: 1 warnings, 0 errors.
  ✅ Scoutica Protocol is ready!

​
Exit codes

CodeMeaning
0All required checks passed
1One or more required checks failed
If doctor reports missing templates or schemas, re-run the installer to restore them:
curl -fsSL https://raw.githubusercontent.com/traylinx/scoutica-protocol/main/install.sh | bash