CLI reference
The cybros CLI brings the Cybros AppSec platform to your terminal: scan repos,
audit posture, run AI reviews, and ship auto-fixes. It ships with the Python SDK.
cybros — enterprise AppSec from your terminal.
Install
pip install cybros # Python 3.10+
cybros version
cybros 0.1.0
Authenticate
cybros login # prompt for a cybros_sk_... key, verify, save
cybros login --api-key cybros_sk_... # non-interactive
Credentials resolve flag → env (CYBROS_API_KEY / CYBROS_API_URL) →
~/.cybros/config.toml. See Authentication for the
full precedence order. Log out (remove the saved key) with:
cybros logout
Global flags
These live on the root command and apply to every subcommand:
| Flag | Description |
|---|---|
--api-url | Override the API base URL for this invocation. |
--json | Emit machine-readable JSON instead of formatted tables. |
--no-color | Disable colored output. |
--help | Show help for any command or group. |
Place global flags before the subcommand:
cybros --json findings --severity high
cybros --api-url http://localhost:8000/api/v1 scan
Config
cybros config reads and writes ~/.cybros/config.toml.
| Command | Description |
|---|---|
cybros config path | Print the config file path. |
cybros config get [KEY] | Show a value, or the whole config (API key masked). |
cybros config set KEY VALUE | Set a value (e.g. base_url). |
cybros config set base_url http://localhost:8000/api/v1
cybros config get base_url
Shell completion
Typer-powered completion for bash, zsh, fish, and PowerShell:
cybros --install-completion # install for your current shell
cybros --show-completion # print the script to inspect / source manually
Restart your shell (or source your rc file) afterward.
JSON output
Add --json to any command to emit the raw API response. Diagnostics stay on a
formatted path; the JSON is clean stdout, so you can pipe it:
cybros --json scan --no-wait | jq '.id'
cybros --json audit | jq '.compliance.overall_score'
cybros --json findings --severity critical | jq '.[].title'
Exit codes
| Code | Meaning |
|---|---|
0 | Success. |
1 | A command error — API error, validation failure, or bad input. |
2 | Not authenticated — no API key resolved (run cybros login). |
Use these to gate CI steps — see GitHub Actions.
Command index
| Command | Purpose | Page |
|---|---|---|
cybros login / logout | Authenticate / clear the saved key. | Authentication |
cybros config | Read/write local config. | above |
cybros repos | List connected repositories. | scan |
cybros scan | Trigger + stream a scan. | scan |
cybros audit | Posture: compliance + AI-security + latest scan. | audit |
cybros report <scan> | Fetch a scan report (table / json / md). | report |
cybros ai review --scan <scan> | Run the 9-agent AI review. | ai-review |
cybros findings | List findings. | findings |
cybros findings show <id> | Full finding detail. | findings |
cybros fix <finding> | Auto-remediation pipeline → PR. | fix |
cybros compliance [framework] | Compliance scores / controls. | compliance |
cybros keys | Create / list / revoke API keys. | keys |
cybros version | Print the installed version. | above |
Everything the CLI does is also available in the Python and TypeScript SDKs.