CLI Commands

The vcro binary. Stdlib Python. No dependencies.

Usage

vcro                         Launch interactive session
vcro <command> [args]        Run a specific command

Core workflows

`vcro query <question>`

Find cohorts matching a scientific or sourcing question. Runs understand, discover, score, deliver.

--slug NAME -- override the auto-generated slug
--max-usd N -- budget cap for the Claude session
--verbose -- stream Claude output to terminal instead of logging to file
--background -- detach and return a run ID
--out-root DIR -- output root (default: store/queries)

`vcro bounty <goal>`

Procure samples. Takes a budget and outcome, produces 1-3 bundle options.

Same flags as query

`vcro onboard <institution>`

Catalog a supply-side institution. Produces listing, compliance, and pricing drafts.

Same flags as query

`vcro lint`

Scan the wiki for gaps, drift, staleness, and broken links.

--max-usd N -- budget cap
--verbose -- stream output

Operator commands

`vcro ingest papers <PMC...>`

Fetch and convert PMC papers into store/raw/papers/. Runs scripts/pmc_convert.py.

`vcro ingest trials <NCT...>`

Fetch and convert ClinicalTrials.gov trials into store/raw/trials/. Runs scripts/ct_convert.py.

`vcro compile <PMC...>`

Extract, resolve, merge papers into the wiki. Parallel fan-out: one Sonnet subagent per paper.

--max-usd N -- budget cap
--verbose -- stream output
--background -- detach

`vcro wiki browse [keyword]`

Browse wiki entities. Shows entity ID, type, and primary signal. Optional keyword filter.

`vcro wiki rebuild`

Regenerate the 7 index files under store/wiki/index/. Idempotent.

`vcro wiki verify`

Revalidate every entity against entity-schema.md. Reports violations.

Utility

`vcro status <run-id>`

Tail a background run's progress log.

`vcro runs`

List recent runs under store/runs/.

`vcro version`

Print viCRO version.

`vcro help [command]`

Show help for a command.

Full help output

vcro -- open-source AI cohort intelligence agent

USAGE
  vcro                         Launch interactive session (like feynman)
  vcro <command> [args]        Run a specific command

CORE WORKFLOWS (the product)
  query <question>           Find cohorts matching a scientific or sourcing question
  bounty <goal>              Procure samples: budget + outcome -> 1-3 bundle options
  onboard <institution>      Catalog a supply-side institution (biobank, hospital, core)
  lint                       Scan the wiki for gaps, drift, staleness, broken links

OPERATOR COMMANDS (for power users / maintainers)
  ingest papers <PMC...>     Fetch + convert PMC papers into store/raw/papers/
  ingest trials <NCT...>     Fetch + convert ClinicalTrials.gov trials into store/raw/trials/
  compile <PMC...>           Extract + resolve + merge papers into the wiki (parallel fan-out)
  wiki browse [keyword]      Browse wiki entities with signal summaries
  wiki rebuild               Regenerate the 7 index files under store/wiki/index/
  wiki verify                Revalidate every entity against entity-schema.md

UTILITY
  status <run-id>            Tail a background run's progress log
  runs                       List recent runs under store/runs/
  version                    Print viCRO version
  help [command]             Show help for a command

Run `vcro <command> --help` for command-specific flags.
Background runs: any workflow supports `--background` to detach and return a run ID.