CLI reference¶
The public Belico Ecosystem CLI (Phase D — v3.1.0) ships 5 commands:
create-paper, smoke-check, verify, catalog and ecosystem. Below is the
full flag and example reference, verified against the source code in
src/belico/commands/.
Installation¶
# From the repo clone (recommended during alpha)
git clone https://github.com/Mikisbell/Belico_Jarvis.git
cd Belico_Jarvis
pip install -e ".[cli]"
# (Coming soon) from PyPI
# pip install belico
Output language is detected from the environment ($LANG); force it with the
global --lang es|en flag or the BELICO_LANG variable.
1. belico create-paper¶
Creates a new paper from the multi-institution template (IMRaD skeleton).
| Flag | Type | Default | Description |
|---|---|---|---|
--venue |
Q1\|Q2\|Q3\|Q4\|Conference |
— (required) | Target quartile. |
--domain |
SHM\|biomedical\|hydraulics\|... |
— (required) | Scientific domain. |
--client |
UC\|Scopus\|SciELO\|PUC\|free |
— (required) | Target client (case-insensitive). |
--output-dir |
path | articles/<auto-slug>/ |
Output directory. |
--briefing |
flag | off | Invoke intake_agent (lazy import). |
--no-intake |
flag | off | Skip intake_agent explicitly. |
--dry-run |
flag | off | Do not run scripts or create files. |
--lang |
es\|en |
env | Output language override. |
# ES (detects $LANG=es_*)
belico create-paper --venue Q1 --domain SHM --client UC --output-dir ./my-paper
# Dry run — does not write files
belico create-paper --venue Q2 --domain biomedical --client free --dry-run
2. belico smoke-check¶
Checks connectivity to the external academic APIs (OpenAlex + CrossRef).
| Flag | Type | Default | Description |
|---|---|---|---|
--apis |
CSV | all | APIs to test (e.g. openalex,crossref). |
--timeout |
int | 60 |
Per-test timeout (seconds). |
--total-timeout |
int | 300 |
Total pytest subprocess timeout. |
--no-online |
flag | off | Run without network (suite-load only). |
--json-output |
flag | off | Structured JSON output for CI. |
--lang |
es\|en |
env | Output language override. |
# Smoke check (requires JARVIS_ONLINE_TESTS=1)
belico smoke-check
# Without network — suite-load check only
belico smoke-check --no-online
# JSON for CI integration
belico smoke-check --json-output
3. belico verify¶
Verifies a paper against the validate_submission harness (strangler-fig).
| Flag | Type | Default | Description |
|---|---|---|---|
--paper-id |
str | — (required) | Paper ID under articles/<paper-id>/. |
--strict |
flag | off | Escalate warnings to errors (exit 1 on warnings). |
--json-output |
flag | off | Structured JSON output for CI. |
--lang |
es\|en |
env | Output language override. |
# Verify by ID (looks up articles/<id>/)
belico verify --paper-id uc-shm-20260415
# Strict — warnings escalate to exit 1
belico verify --paper-id my-paper --strict
# JSON envelope
belico verify --paper-id my-paper --json-output
4. belico catalog¶
Lists available harnesses, sub-agents, tools and skills. It is the source that feeds the auto-generated catalog pages (Harnesses, Skills, Sub-agents, Tools).
| Flag | Type | Default | Description |
|---|---|---|---|
--type |
harness\|agent\|tool\|skill\|all |
all |
Filter by category. |
--status |
active\|planned\|planned-v0\|deprecated\|all |
all |
Filter by status. |
--output-format |
table\|json\|yaml |
table |
Output format. |
--limit |
int | no limit | Max rows per category. |
--lang |
es\|en |
env | Output language override. |
# All categories
belico catalog
# Filter by type
belico catalog --type harness
# Filter by status
belico catalog --status active
# JSON output (consumed by tools/gen_catalog_md.py)
belico catalog --output-format json
5. belico ecosystem¶
Ecosystem status snapshot (recent commits + roadmap + counts).
| Flag | Type | Default | Description |
|---|---|---|---|
--status |
flag | on | Show the status snapshot (default). |
--deep |
flag | off | Include coverage parse (coverage.xml), slower. |
--commits |
int | 10 |
Number of recent commits to show. |
--commits-since |
int | 7 |
Days back for the git log. |
--output-format |
panel\|json |
panel |
Output format. |
--lang |
es\|en |
env | Output language override. |
# Default — rich panel
belico ecosystem
# Deep — includes coverage (slow)
belico ecosystem --deep
# Last 20 commits
belico ecosystem --commits 20
# JSON
belico ecosystem --output-format json
Exit codes¶
| Code | Meaning |
|---|---|
0 |
Success / OK |
1 |
Warnings with --strict |
2 |
Blocker errors or subprocess failure |
3 |
Resource not found (paper-id, etc.) |
130 |
User cancelled (Ctrl-C) |
Status
178 green tests · TOTAL coverage 89% · CI matrix Ubuntu/Windows/macOS × Python 3.10/3.11/3.12.