Overview

The Antigen CLI lets you launch agents, follow runs, and retrieve vulnerabilities and evidence from your terminal. It uses the same API as the Antigen SDK, so you can work with the same resources from scripts, CI pipelines, and the platform. After installing the CLI, sign in:

antigen login

Follow the instructions to authorize the CLI in your browser using your Google account. The CLI saves your credentials for subsequent commands. For CI pipelines, set ANTIGEN_API_KEY in your environment. The CLI uses that key automatically. See CI/CD for configuring automated runs.

Start a run

Launch tCell against an approved target:

antigen run --targets api.example.com

The CLI prints the run ID and streams activity as the agent works:

Run run_abc123 started
Agent: tCell
Targets: api.example.com

Investigating authentication and API endpoints...
HIGH      SQL injection in /api/users
CRITICAL  Authentication bypass on /api/admin

Run complete. 1 critical, 1 high vulnerability.

The command waits until the run finishes. The run continues in its sandbox if your terminal disconnects. Targets must be approved before testing. See Targets for the approval process.

Commands

Command	Purpose
`antigen login`	Sign in through your browser.
`antigen logout`	Clear saved credentials.
`antigen targets`	List targets and their approval status.
`antigen run`	Start an agent and follow its progress.
`antigen runs`	List runs.
`antigen vulnerabilities <run-id>`	Read vulnerabilities associated with a run.
`antigen evidence <run-id>`	List evidence associated with a run.
`antigen download <evidence-id>`	Download an evidence item.
`antigen steer <run-id> "<message>"`	Give the agent context, direction, or a follow-up question.
`antigen stop <run-id>`	Snapshot the sandbox and stop the run.
`antigen resume <run-id>`	Continue a stopped run from its snapshot.
`antigen open <run-id>`	Open a run in the platform.
`antigen version`	Print the installed CLI version.

See Commands for arguments, options, and examples.

Getting started

Asset Map

Runs

Vulnerability Lifecycle

Team Workflows

SDK

CLI

Integrations

Start a run

Commands

​Sign in

​Start a run

​Commands

Sign in

Start a run

Commands