Skip to content
Scoutica Protocol

scoutica doctor

The doctor command acts as your infrastructure diagnostic tool. High-fidelity protocols like Scoutica rely heavily on local machine tools (CLI LLMs, Python libraries, standard shell binaries).

Command Syntax

Section titled “Command Syntax”
Terminal window
scoutica doctor

Diagnostic Pipeline

Section titled “Diagnostic Pipeline”

scoutica doctor aggressively scopes your active $PATH and underlying host system:

  1. Core Verification: Checks if ~/.scoutica/bin, schemas, and templates exist and possess exact protocol files.
  2. Library Constraints: Requires Python 3.11+ plus jsonschema[format] and PyYAML, and checks core Unix dependencies such as git. Missing Python packages are reported with python3 -m pip install 'jsonschema[format]' PyYAML; doctor does not install them.
  3. AI Discovery: Iterates through supported AI CLIs (gemini, claude, codex, ollama, ail, openclaw) to ensure scoutica scan has a proper intelligence backplane available.
  4. Toolchain Modules: Scans optionally for pdftotext required to parse resume PDF blobs.

Why use it:

  • If an installation completely fails or is throwing /bin/bash missing binaries errors.
  • If you change computers and copy your environment but forget why your AI extraction isn’t running. You run scoutica doctor and it actively flags: ❌ No known AI CLI found!.

Typical Healthy Diagnosis

Section titled “Typical Healthy Diagnosis”
╔═══════════════════════════════════════════════════════╗
║   🩺 Scoutica Diagnostics                            ║
╚═══════════════════════════════════════════════════════╝


✔ Base Directory    : /home/traylinx/.scoutica
✔ CLI Executable    : Found (v0.1.0)
✔ Template Directory: Found (3 files)
✔ Schema Directory  : Found (5 schema files)


✔ Python Toolkit    : Python 3.11+ with jsonschema and PyYAML
✔ Git               : git installed
✔ PDF Extractor     : pdftotext installed


✔ AI Providers      : claude (Claude Code), gemini (Gemini CLI)