Skip to content
Scoutica Protocol

scoutica status

status is your at-a-glance dashboard. It reads the local card registry and lists every Skill Card you’ve generated, showing where each one lives on disk, whether it’s been published, and how recently it was scanned. Use it to answer “what cards do I have, and which ones still need publishing?”

Command Syntax

Section titled “Command Syntax”
Terminal window
scoutica status

No arguments or flags.

What it reports

Section titled “What it reports”

The registry lives at ~/.scoutica/registry.json and is populated by scoutica scan. If no cards are registered yet, status says so and points you at scoutica scan <docs-folder> to create your first card.

Otherwise, cards are listed most-recently-scanned first, and for each card status shows:

Field Meaning
📁 Card dir The card’s directory path
Name Candidate name (and title, if set)
GitHub Published URL, or not published yet
Preview Preview URL, if one was recorded
Last scan Date of the most recent scan, plus the AI provider that ran it
Published Date last published (only shown if published)
Scans Total number of times the card has been scanned
Status ✅ Folder exists, or ❌ Folder deleted — run scoutica scan to regenerate if the directory is gone

Cards whose folder no longer exists are flagged [MISSING].

Summary line

Section titled “Summary line”

After the per-card list, status prints a one-line roll-up:

─────────────────────────────────────
3 card(s) total | 2 published | 1 missing
  • total — cards in the registry
  • published — cards that have a GitHub URL
  • missing — cards whose folder is no longer on disk

Example

Section titled “Example”
╔═══════════════════════════════════════════════════════╗
║   Card Status Dashboard                               ║
╚═══════════════════════════════════════════════════════╝


  📁 ./alice-card
     Name:      Alice Developer — Senior Backend Engineer
     GitHub:    https://github.com/alice/scoutica-card
     Last scan: 2026-07-01 (claude)
     Published: 2026-07-02
     Scans:     4 total
     Status:    ✅ Folder exists


  ─────────────────────────────────────
  1 card(s) total | 1 published | 0 missing