Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scoutica.com/llms.txt

Use this file to discover all available pages before exploring further.

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

scoutica doctor

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: Scans for Python 3 and ensures core Unix dependencies (like git required for scoutica publish) exist.
  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

╔═══════════════════════════════════════════════════════╗
║   🩺 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    : python3 installed
✔ Git               : git installed
✔ PDF Extractor     : pdftotext installed

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