Skip to content

Command line

Run these in the verentis-app folder with the virtual environment active. verentis <command> --help prints the same options.

Command What it does
verentis install Install dependencies, and fix a known macOS packaging issue.
verentis setup The interactive setup wizard.
verentis train <url> [max_pages] Learn your product from your website (default 100 pages). Options: --provider claude|codex, --model, --reasoning-effort.
verentis status Pipeline summary. --check also checks the Claude or Codex CLI without sending a prompt.
verentis usage Model quota and per-agent token usage. --days (default 30).
Command What it does
verentis run Start the heartbeat loop: wake, check budget, act, sleep.
verentis dashboard Start the dashboard on 127.0.0.1:5555 and print its private link. --port, --host (loopback only), --url prints the link and exits.
verentis admin Print the superadmin console link. --url prints only the link. The dashboard must be running.
verentis sending pause|resume|status The kill switch for all outbound email.
Command What it does
verentis signals List the signal catalog and what is on. --confirm CODES (or free, all), --reject CODES.
verentis discover Find businesses. --providers lists sources with prices; --estimate prices without calling. Options: --provider, --city "A; B", --depth (default 30), --limit (default 100), --max-spend (default 1.00 USD), --no-profile.
verentis profile Read found companies’ websites for free signals. --limit (default 200), --stale-days (default 90).
Terminal window
verentis map <domain> --use-case "..." [options]
Option Meaning
--use-case Required. What you sell into, in plain words.
--company Company name (default: from the domain).
--evidence file.json Use your own evidence instead of fetching.
--judge auto|jev|claude Override committee.judge for this run.
--verify Also check each kept person’s professional footprint.
--no-draft Skip message angles and drafts.
--dry-run Do not save to the database or data/maps.
--markdown Print the full Markdown report.
Terminal window
verentis eval labels.csv [--judge both|jev|claude] [--holdout 0.3]

Scores the judges against labelled people. CSV columns: account,use_case,name,title,label,evidence. Reports go to data/eval/.

Terminal window
verentis verify "<name>" --company "..." --domain example.com [options]
Option Meaning
--title Job title, for headline matching.
--email A verified work email, to try its local part as a handle.
--link URL A profile URL already known (repeatable).
--sources a,b Only these source keys.
--all Also list sources with no profile.
--dry-run Do not save the report.
--selftest Check every source’s detection rules, then exit.
Terminal window
verentis track [run|watchlists|pause|resume|moments|digest|draft] [target]
Form What it does
verentis track or track run Check due watchlists. --force checks all; --company limits to one account; --no-ai uses keyword rules instead of Claude.
verentis track watchlists List watchlists.
verentis track pause <id> / resume <id> Pause or resume one watchlist.
verentis track moments List moments to reach out.
verentis track draft <moment id> Draft a first message for a moment.
verentis track digest Changes and moments for the last --days (default 1).
Command What it does
verentis outbox Review queued email. --approve ID, --approve-all, --reject ID.
verentis export Deliverable contacts as a CSV (prospects.csv). --out, --email-status (default verified,risky), --min-score, --status, --all.
verentis gmail auth|test One-time Gmail sign-in, and a connection check.
verentis microsoft auth|test One-time Microsoft 365 sign-in, and a connection check.