agentx

agentx is a portable, verifiable bundle (.agentx) that carries an agent’s instructions, tools, policy/capabilities, evals, and provenance.

This repo ships an agentx implementation:

• A strict bundle layout (zip container, .agentx)
• manifest.json with content-addressed hashes
• Pack/unpack/verify tooling
• Optional Ed25519 signing of the manifest
• A lightweight eval checker (validates eval/tests.jsonl against bundled goldens)

Quickstart

# Create a new bundle directory
go run ./cmd/agentx init ./my-agent

# After editing bundle files, update hashes + id
go run ./cmd/agentx update ./my-agent

# Pack it into a .agentx file
go run ./cmd/agentx pack ./my-agent --out ./my-agent.agentx

# Verify bundle integrity
go run ./cmd/agentx verify ./my-agent.agentx

Signing

# Create an Ed25519 keypair
go run ./cmd/agentx keygen ./keys

# Sign a directory (writes provenance/signatures/manifest.ed25519.json)
go run ./cmd/agentx sign ./my-agent --key ./keys/agentx_ed25519_private.pem

# Pack + sign (signature is embedded under provenance/signatures/)
go run ./cmd/agentx pack ./my-agent --out ./my-agent.agentx --sign --key ./keys/agentx_ed25519_private.pem

# Verify (includes signature verification if present)
go run ./cmd/agentx verify ./my-agent.agentx

Example

See examples/support-agent/ for a small, working bundle directory you can pack and verify.

License

MIT