CLI reference

pip install combo-cli
# or from a private wheel in the deployment bundle:
pip install /path/to/combo_cli-*.whl

combo-cli config init
# interactively captures base URL + API key

combo-cli auth login              # sign in
combo-cli auth whoami             # active principal
combo-cli config show             # inspect config
combo-cli config set base-url ... # change endpoint

combo-cli agent list
combo-cli agent create --name "Code review" --scenario code-review
combo-cli agent show <agent_id>
combo-cli agent delete <agent_id>
 
combo-cli session list --agent <agent_id>
combo-cli session show <session_id>
combo-cli session archive <session_id>
combo-cli session export <session_id> -o session.json  # snapshot session

combo-cli chat \
  --session <session_id> \
  --question "Review https://gerrit.../c/12345"
 
combo-cli chat --stream --session <session_id> --question "..."
 
combo-cli chat --session <session_id> --input-file question.md

combo-cli kb list
combo-cli kb create --name "ABZ program standards"
combo-cli kb show <kb_id>
 
combo-cli doc upload --kb <kb_id> ./docs/*.pdf
combo-cli doc upload --kb <kb_id> --recursive ./docs/
combo-cli doc list --kb <kb_id>
 
combo-cli doc wait --kb <kb_id>
combo-cli doc reparse <doc_id> --parser patent

combo-cli skill list
combo-cli skill show <skill_id>
 
combo-cli skill publish ./my-skill/
combo-cli skill activate <skill_id> --session <session_id>

combo-cli cron list
combo-cli cron create --name "Daily review" \
  --expr "0 9 * * *" \
  --agent <agent_id> \
  --prompt "Review yesterday’s PR backlog"
 
combo-cli cron delete <cron_id>

combo-cli trigger list
combo-cli trigger create --from ./trigger.yaml
combo-cli trigger test <trigger_id> --event-file ./event.json  # dry run

combo-cli tenant list
combo-cli tenant create --name "Corp A" --quota "tokens=10M/month"
 
combo-cli user list --tenant <tenant_id>
combo-cli user create --tenant <tenant_id> --email "alice@corp-a.com"
combo-cli user disable <user_id>

combo-cli credential list
combo-cli credential add \
  --name "DNG-Production" \
  --type oauth2 \
  --config ./dng-config.yaml
 
combo-cli credential rotate <credential_id>
combo-cli credential revoke <credential_id>

combo-cli import requirements \
  --kb <kb_id> \
  --source req.csv \
  --mapping req-mapping.yaml

columns:
  id: "REQ_ID"
  title: "Title"
  description: "Description"
  type: "Req_Type"
  asil: "ASIL"
relations:
  satisfies: "Satisfies"   # column referencing parent IDs

combo-cli session export \
  --tenant <tenant_id> \
  --since "2026-01-01" \
  --output-dir ./exports/

combo-cli export --tenant <tenant_a> -o a-data/
 
combo-cli import --tenant <tenant_b> -i a-data/ --mapping-file map.yaml

combo-cli debug ledger <session_id>
# prints each round: action / result / confidence

combo-cli debug replay <session_id> --from-round 5

combo-cli debug hooks <session_id>

combo-cli debug trace <trace_id> --format jaeger > trace.json

combo-cli health                 # cluster health
combo-cli health --verbose       # dependency drill-down
 
combo-cli stats usage --tenant <tenant_id> --last 7d
combo-cli stats cost --tenant <tenant_id> --breakdown model
 
combo-cli maintenance gc         # invoke GC
combo-cli maintenance reindex --kb <kb_id>

export COMBO_BASE_URL=https://api.combo.example.com
export COMBO_API_KEY=ragflow-...
export COMBO_TENANT=t_corp_a
 
combo-cli agent list

combo-cli completion bash >> ~/.bashrc
combo-cli completion zsh >> ~/.zshrc
combo-cli completion fish > ~/.config/fish/completions/combo-cli.fish