Skip to main content
The attesta CLI is installed automatically with the Python package. It provides subcommands for project initialization, audit log inspection, trust management, and MCP server proxying.

​
Installation

pip install attesta
Verify the installation: 
attesta version

attesta 0.1.0

​
Command Tree

CommandDescription
attesta initCreate attesta.yaml in current directory
attesta init --forceOverwrite existing config
attesta audit
attesta audit verifyVerify hash-chain integrity
attesta audit statsPrint approval statistics
attesta audit rubber-stampsList suspiciously fast approvals
attesta trust
attesta trust show <agent_id>Show trust profile for an agent
attesta trust listList all agents and trust scores
attesta trust revoke <agent_id>Revoke trust for an agent
attesta mcp
attesta mcp wrap -- <command>Wrap MCP server with Attesta proxy
attesta versionPrint the attesta version

​
Default Paths

All data files are stored in a .attesta/ directory within your project:
FileDefault PathDescription
Audit log.attesta/audit.jsonlSHA-256 hash-chained JSONL audit trail
Trust store.attesta/trust.jsonPer-agent trust profiles and history
Configattesta.yamlProject-level configuration
You can override any default path using the --log, --store, or --config flags on the respective subcommands.

​
Global Help

Every command and subcommand supports --help: 
attesta --help
attesta audit --help
attesta trust show --help
attesta mcp wrap --help

​
Quick Examples

attesta init

​
Next Steps

attesta init

Generate an attesta.yaml config file

attesta audit

Inspect and verify the audit trail

attesta trust

Manage agent trust profiles

attesta mcp wrap

Proxy MCP servers with approval