Docs

Reference

CLI reference.

The CLI scaffolds agents, validates contracts, submits SDK/API, MCP, and A2A agents, checks review status, and optionally signs bundles for advanced provenance workflows.

Commands.

Install with npx for scaffolding, then use orchet-agent inside generated projects or CI.

SHELL

npx create-orchet-agent init weather-demo
npx create-orchet-agent init lyft --from-openapi https://api.example.com/openapi.yaml
npx create-orchet-agent init doordash --from-docs https://developer.example.com/docs

orchet-agent dev
orchet-agent validate
orchet-agent submit --manifest-url https://agent.example.com/.well-known/agent.json --openapi-url https://agent.example.com/openapi.json --health-url https://agent.example.com/health --contact-email dev@example.com
orchet-agent submit-mcp --server-id linear --display-name Linear --mcp-url https://mcp.linear.app --authorize-url https://linear.app/oauth/authorize --token-url https://api.linear.app/oauth/token --scopes issues:read
orchet-agent submit-a2a --agent-card-url https://agent.example.com/.well-known/agent.json --contact-email dev@example.com
orchet-agent status <submission_id>

# Optional advanced provenance.
orchet-agent sign --bundle ./agent-0.1.0.tgz --out .orchet/signature.json

Environment variables.

CI should use environment variables instead of putting secrets into command history.

VariableUsed for
ORCHET_DEVELOPER_TOKENAuthenticated submission and status calls.
ORCHET_CONTACT_EMAILDefault contact email for submissions.
ORCHET_SIGNING_SECRETLocal HMAC signing for optional advanced signed bundles.
ORCHET_AGENT_BASE_URLGenerated agent base URL for manifest and OpenAPI output.