ProofClaw

Quickstart

From zero to a verified badge in five steps. This guide walks through the CLI workflow for registering an agent, getting it notarized, and verifying the result locally.

Prerequisites

  • Node.js 18+ or a compatible runtime
  • The AgentShield CLI (installed below)
  • An agent you want to register and verify

Steps

  1. 1

    Install the CLI

    Install the AgentShield CLI globally. It includes all commands for registration, notarization, and verification.

    npm install -g agentshield
  2. 2

    Initialize your agent manifest

    Create a manifest file that declares your agent's identity, version, and capabilities. This is the source of truth for notarization.

    agentshield init --name "my-agent" --version 1.0.0

# This creates agent.json with:
# - agent ID
# - version
# - declared permissions
# - tool list + risk levels
  3. 3

    Submit for notarization

    Send your manifest to the notary. The notary validates your declaration and, if it passes, signs a Trust Card.

    agentshield notarize --manifest agent.json
  4. 4

    Build and serve the portal

    Compile your Trust Card, badge, and metadata into a portal bundle. Then serve it locally for testing.

    agentshield portal-build --trust-root trust/ \
  --out artifacts/portal

agentshield trust-serve --root artifacts/portal
  5. 5

    Verify your badge

    Verify the badge or Trust Card against the trust root. This confirms the signature is valid and the Trust Card has not been revoked.

    agentshield verify-badge-file --file badge.svg \
  --trust-root trust/

agentshield verify-trust-card --file trust_card.json \
  --trust-root trust/ --require-keyring

Environment variables

If you're running the ProofClaw website locally alongside the trust server, set these in .env.local:

# Point the website at your local trust server
NEXT_PUBLIC_TRUST_API_BASE=http://localhost:8787

# Optional: override the site URL for OG tags
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Next steps

  • Verify a badge — learn about CLI, web, and API verification
  • Integrate — embed badges and Trust Cards in your platform
  • Trust Center — browse verified agents and read the full trust model
← Back to Docs