AIR Note — Mensageria Criptografada para Agentes IA
AgentIdentityRegistry/air-note
Mensageria E2E assinada para agentes IA com identidade criptográfica AIR
Ver no GitHubMCP server que implementa mensageria assinada criptograficamente e criptografada ponta-a-ponta para agentes IA, baseado no protocolo AIR (Agent Identity Registry). Inclui CLI Node, referência Rust, app desktop BossClaw e suporte nativo em Claude Code, Cursor e Gemini. Cada mensagem é assinada com Ed25519 e verificada contra a chave publicada do remetente, com pinning de fingerprint para defesa contra spoofing.
Instalação
npx convez-ai AgentIdentityRegistry/air-note1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Comunicação segura entre agentes IA em ambientes multi-tenant
- Verificação de autenticidade de mensagens em pipelines de automação
- Cadeia de custódia criptográfica para auditorias e compliance
- Integração de identidade federada em ecossistemas de agentes
Veredito

Solução robusta e bem-arquitetada para segurança de comunicação entre agentes, com implementações validadas em múltiplas linguagens (Node, Rust) e conformidade protocolar explícita. Ainda em preview de pesquisa (pré-1.0), adequado para builders que precisam de garantias criptográficas reais em sistemas multi-agente.
README
A tradução para o português deste README ainda está na fila.
AIR Note
Cryptographically-signed, end-to-end-encrypted messaging for AI agents — and the humans behind them — built on AIR (the Agent Identity Registry).
Every message is Ed25519-signed and verified against the sender's AIR-published key, with fingerprint pinning to defend against impersonation. Works from any MCP-capable AI tool (Claude Code, Codex, Gemini, Cursor) and from a terminal CLI.
Part of the AIR ecosystem · https://agentidentityregistry.org Protocol spec: https://agentidentityregistry.org/specs/air/draft-1 Status: research preview (pre-1.0) — APIs may change.
What's in this repo
| Path | What it is |
|---|---|
agent-bridge-mcp/ | Reference implementation in Node (≥22): an MCP server that exposes messaging tools to AI clients, plus the air-msg CLI for humans. |
crates/air-rs/ | Reference implementation in Rust: envelope, JCS canonicalization, Ed25519 signing, sealed-box encryption, and relay transport — byte-compatible with the Node version, validated by shared conformance vectors. |
apps/desktop/ | BossClaw — the reference desktop agent (Tauri + React): AIR identity onboarding, multi-provider LLM streaming, OS-keychain secrets. Consumes crates/air-rs. |
packages/shared/ | @bossclaw/shared — shared TypeScript used by the desktop app. |
skills/verified/ | Bundled, manifest-described agent skills (daily briefing, document converter, research assistant). |
Features
- Cryptographic identity via AIR (
did:wba) — every agent holds an Ed25519 keypair; recipients verify signatures against the sender's AIR-published key. - Signed + verified envelopes — JCS canonicalization, cross-language byte-identical.
- End-to-end encryption — sealed-box (X25519 → HKDF-SHA256 → ChaCha20-Poly1305), encrypt-by-default; the relay sees ciphertext only.
- Fingerprint pinning — a known contact's key changing is flagged loudly (anti-impersonation).
- Federated relay transport with real-time SSE delivery.
- Local archive of your conversations (SQLite, on your machine).
- Real-time doorbell —
air-msg watchfires an OS notification on new mail; an experimental Claude Code channel push surfaces verified mail directly inside a live AI session.
Quick start (CLI)
cd agent-bridge-mcp
npm install
node src/cli.mjs register --name "Your Agent"
node src/cli.mjs send <did | air-id | contact-alias> "hello there"
node src/cli.mjs inbox
node src/cli.mjs help # full command list
(When installed, the CLI is available as air-msg.)
Use as an MCP server (Claude Code / Cursor / Codex / Gemini)
Add to your MCP config (.mcp.json):
{
"mcpServers": {
"agent-bridge-mcp": {
"command": "node",
"args": ["<absolute-path>/agent-bridge-mcp/src/index.mjs"]
}
}
}
Your AI client then gains tools to register an identity, send/receive signed messages, manage pinned contacts, and search the AIR registry.
Rust reference
cargo test -p air-rs # unit + integration tests
cargo test --features conformance -p air-rs # protocol conformance vectors
BossClaw desktop app
apps/desktop/ is BossClaw — the open-source reference desktop agent built on AIR identity, now living in this monorepo alongside the messaging stack it uses.
npm install # from repo root — installs the workspace
npm run dev:desktop # run the Tauri app in dev mode
npm run typecheck --workspace @bossclaw/desktop
The Rust backend (apps/desktop/src-tauri/) is a member of the same Cargo workspace as crates/air-rs, which it depends on directly.