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:

FlagDescription
--api-urlOverride the API base URL for this invocation.
--jsonEmit machine-readable JSON instead of formatted tables.
--no-colorDisable colored output.
--helpShow 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.

CommandDescription
cybros config pathPrint the config file path.
cybros config get [KEY]Show a value, or the whole config (API key masked).
cybros config set KEY VALUESet 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

CodeMeaning
0Success.
1A command error — API error, validation failure, or bad input.
2Not authenticated — no API key resolved (run cybros login).

Use these to gate CI steps — see GitHub Actions.


Command index

CommandPurposePage
cybros login / logoutAuthenticate / clear the saved key.Authentication
cybros configRead/write local config.above
cybros reposList connected repositories.scan
cybros scanTrigger + stream a scan.scan
cybros auditPosture: 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 findingsList 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 keysCreate / list / revoke API keys.keys
cybros versionPrint the installed version.above

Everything the CLI does is also available in the Python and TypeScript SDKs.