OpenA2A CLI

Unified security platform for AI agents. 24 commands, 5 input modes, 706 tests.

Installation

Try without installing
npx opena2a-cli init
npm
npm install -g opena2a-cli
Homebrew
brew install opena2a-org/tap/opena2a

Core Commands

Built-in commands with direct implementations.

Adapter Commands

Commands that delegate to external tools through the CLI's adapter system.

CommandAdapterDescription
registryAI TrustTrust Registry queries
identityAIMAgent identity management
trainDVAAVulnerable agent training
cryptoCryptoServePQC readiness
brokerSecretlessCredential broker daemon

Global Flags

FlagDescription
--ciCI mode. No interactive prompts, machine-readable output.
--quietSuppress non-essential output.
--verboseVerbose output with details.
--format <text|json|sarif>Output format. Default: text.
--contributeShare anonymized scan results with the community.
-v, --versionShow CLI version.
-h, --helpShow help.

Guides

Command Categories

The 24 commands are organized into six functional categories that cover the full agent security lifecycle:

CategoryCommandsPurpose
Detectiondetect, mcp, statusDiscover unmanaged AI agents, MCP servers, and aggregate security posture.
Identityclaim, trust, self-register, verifyManage agent identities, trust profiles, and binary integrity verification.
Governancescan-soul, harden-soul, reviewEvaluate and improve behavioral governance (SOUL.md) against OASB v2 controls.
Scanningscan, benchmark, baselines, secretsRun security checks, attack simulations, behavioral profiling, and credential scans.
Protectioninit, protect, guard, shield, runtimeAssess posture, fix findings, sign configs, orchestrate defenses, and monitor at runtime.
Trustconfig, demoManage CLI preferences and run interactive security walkthroughs.

Quick Start

After installation, the fastest way to assess your project is the three-command workflow:

# 1. Assess project security posture and trust score
opena2a init

# 2. Auto-fix credential leaks, .gitignore gaps, and config signing
opena2a protect

# 3. Full multi-phase review with HTML report
opena2a review

For CI/CD pipelines, append --ci --format json to any command for machine-readable output and non-zero exit codes on failures. See the CI/CD Integration guide for full pipeline examples.

Verify Installation

$ opena2a --version
opena2a-cli v0.5.4

$ opena2a --help
Usage: opena2a <command> [options]

Commands:
  init, protect, guard, runtime, verify, shield,
  detect, mcp, trust, claim, demo, scan, secrets,
  benchmark, review, scan-soul, harden-soul, ...

Source: github.com/opena2a-org/opena2a | Published on npm as opena2a-cli