@agentid-protocol/cli

Command-line tool for managing AI agent identities, manifests, and trust verification.

Install

npm install -g @agentid-protocol/cli

Or run directly with npx:

npx @agentid-protocol/cli <command>

Requires Node.js >= 18.

Commands

agentid init

Generate a new Ed25519 keypair for your agent.

agentid init
# Creates keypair.json with 0600 permissions

agentid init --output my-agent.json
# Custom output path

agentid init --force
# Overwrite existing keypair

agentid manifest create

Create an agent manifest declaring identity, capabilities, and constraints.

agentid manifest create \
  --name "PaymentBot" \
  --agent-version "1.0.0" \
  --capabilities "payments:send,data:read" \
  --expires "2027-01-01T00:00:00Z"

agentid sign

Sign a manifest with your private key.

agentid sign
# Signs manifest.json using keypair.json, outputs signed-manifest.json

agentid sign --manifest my-manifest.json --keypair my-agent.json --output signed.json

agentid verify

Verify a signed manifest's signature, expiry, and trust level.

agentid verify signed-manifest.json

agentid policy test

Test a policy against a signed manifest and action.

agentid policy test \
  --manifest signed-manifest.json \
  --action "payments:send" \
  --policy policy.json

agentid rotate

Rotate to a new keypair with a signed continuity proof.

agentid rotate
# Generates new keypair, creates rotation statement signed by old key

agentid revoke

Revoke an agent identity.

agentid revoke --reason "Key compromised"
# Creates a signed revocation statement

Typical workflow

# 1. Generate identity
agentid init

# 2. Create manifest with capabilities
agentid manifest create \
  --name "MyAgent" \
  --agent-version "1.0.0" \
  --capabilities "data:read,data:write"

# 3. Sign it
agentid sign

# 4. Share signed-manifest.json with verifiers

# 5. Verifier checks it
agentid verify signed-manifest.json

# 6. Test against a policy
agentid policy test \
  --manifest signed-manifest.json \
  --action "data:read" \
  --policy policy.json

SDK

The CLI is built on top of @agentid-protocol/core. For programmatic usage, install the core SDK directly:

npm install @agentid-protocol/core

Links

• GitHub
• Core SDK
• Python SDK
• Examples

License

Apache 2.0