Skip to main content

Syntax

scoutica preview [directory]

Options

directory
string
Path to a directory containing your generated Skill Card files (profile.json, rules.yaml, evidence.json). Defaults to the current directory.

What it does

scoutica preview reads your generated card files, compiles them into a responsive, Neo-Brutalist HTML page, and instantly publishes it to the web via here.now — a free, instant web host for AI agents. The command:
  1. Reads profile.json, rules.yaml, and evidence.json from the target directory
  2. Generates a styled index.html in a .preview/ subdirectory
  3. Publishes the .preview/ directory to here.now
  4. Prints the live public URL in your terminal

Usage examples

# Preview the card in the current directory
scoutica preview

# Preview a card in a specific folder
scoutica preview ./my-card/

Prerequisites

The here.now publisher must be installed. Install it with:
curl -fsSL https://here.now/install.sh | bash

Auto-preview after scan

When here.now is installed, scoutica scan automatically chains into scoutica preview after a successful card generation. You get the live URL without running a second command:
scoutica scan ~/CV/ --with gemini
# → generates card files
# → automatically builds and publishes preview
# → prints live URL

Expected output

  → Compiling Neo-Brutalist HTML presentation...
  ✅ Generated Neo-Brutalist HTML
  → Publishing to the web via here.now...

╔═══════════════════════════════════════════════════════╗
║                                                       ║
║   🌍 Your Skill Card is live globally!                ║
║      https://merry-maple-tgng.here.now                ║
║                                                       ║
╚═══════════════════════════════════════════════════════╝

  (This is an instant anonymous publish hosted via here.now)

  What to do next:

  • scoutica publish .    Push this generated card to GitHub and share
Anonymous publishes on here.now expire after 24 hours. To make your preview permanent, sign up at here.now and set an API key.

Next steps

scoutica publish .    # push your card to GitHub for permanent hosting
scoutica validate .   # check for schema errors