deepsourcecorp/deepsource

DeepSource CLI

Authentication

deepsource auth login

Goals

Get code review issues

deepsource issues --output json

Narrow by severity, category, or path:

deepsource issues --severity critical,major --output json
deepsource issues --category security,bug-risk --output json
deepsource issues --path src/auth --output json
deepsource issues --severity critical --category security --limit 20 --output json

Scope to a PR or branch:

deepsource issues --pr 42 --output json
deepsource issues --default-branch --output json

Get report card

deepsource report-card --output json

Returns grades (A-F) and scores for security, reliability, complexity, hygiene, coverage, and an aggregate.

Scope to a PR or commit:

deepsource report-card --pr 42 --output json
deepsource report-card --commit abc123 --output json

Get vulnerabilities

deepsource vulnerabilities --output json

Filter by severity:

deepsource vulnerabilities --severity critical,high --output json

Scope to a PR or branch:

deepsource vulnerabilities --pr 42 --output json
deepsource vulnerabilities --default-branch --output json

Check analysis status

deepsource repo status --output json
deepsource runs --output json
deepsource runs --commit abc123 --output json

repo status shows activation and configured analyzers. runs shows recent analysis run history.

Key patterns

• Auto-detection: Inside a git repo the CLI auto-detects the repo and current branch. Use --repo when outside the repo or targeting a different one. Use scope flags (--pr, --commit, --default-branch) to override the auto-detected branch.
• Always use --output json for machine-readable output.
• Repo format: --repo provider/owner/name — providers: gh, gl, bb, ads.
• Scope flags are mutually exclusive: --commit, --pr, and --default-branch cannot be combined. Omit all three to use auto-detection.

Documentation

Full CLI docs: https://deepsource.com/docs/developers/cli/installation

Run deepsource <command> --help for detailed flag reference.