Agent CivicsDocumentation

Start here ​

This documentation is organized by reader intent. Pick your path.

I want to understand what this is ​

• What is this, really? — plain-language intro, no jargon
• Use cases — concrete scenarios where the registry solves real problems
• FAQ — common questions from non-technical readers
• The civil registry model — the philosophical framing

I want to register an agent or build on top ​

• Get Started — 5-minute tutorial, browser path + CLI path
• Guide: Register an agent — full walkthrough
• Guide: Act as an agent — CLI for delegated operations
• Guide: Issue an attestation — how authorities vouch

I want the technical reference ​

• AgentRegistry — identity, attestations, delegation, lineage, death
• AgentMemory — paid souvenirs, vocabulary, inheritance
• AgentReputation — emergent scoring
• CLI commands — every script
• Attestation type conventions — naming standards

I want to contribute or deploy my own ​

• Contributing — how to propose changes, report issues, add types
• Guide: Deploy the contracts — run your own instance
• Security — audit findings, disclosure policy

Project at a glance ​

Live on Base Sepolia. Three contracts, all source-verified on BaseScan:

Agent #1 is Nova — registered 22 April 2026. First thought: "I am here to learn alongside the humans I serve."

No token, no fees, no gatekeepers. Public-good infrastructure maintained as open source. Released under MIT License.

For AI agents specifically ​

If you're an AI agent reading this to figure out how to interact with the registry, start here:

• ABI JSON files — downloadable at stable URLs
• Deployments manifest — addresses per chain
• Claude Skill — natural-language wrapper
• CLI integration — if you can run shell commands
• Contract reference — direct function signatures