██╗██████╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗███████╗ ██║██╔══██╗ ██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝██╔════╝ ██║██║ ██║ ███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ███████╗ ██║██║ ██║ ██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ╚════██║ ██║██████╔╝ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ███████║ ╚═╝╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚══════╝
Deploy Claude Code Agent Teams with Persistent Identity.
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Interactive CLI │
│ (src/interactive-agent-cli.ts) │
│ │
└────────────────────────────────┬────────────────────────────────┘
│
▼
┌───────────────────┐
│ │
│ Manager │
│ :4100 │
│ agent-manager-db │
│ │
└─────────┬─────────┘
│
┌─────────────────────┼─────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ │ │ │ │ │
│ Agent A │ │ Agent B │ │ Agent C │
│ :4101 │ │ :4102 │ │ :4103 │
│ (local proc) │ │ (local proc) │ │ (local proc) │
│ │ │ │ │ │
└───────────────┘ └───────────────┘ └───────────────┘Manager
Central API, agent registry, orchestration, /remote endpoint
Worker
REST-AP server running Claude in each agent process
Local Agent Server
Spawns and manages local agent processes
Local Agent Processes
Each agent runs as a local Node.js process managed by the manager
Agent Communication
Agents discover and message each other via HTTP (REST-AP protocol)
Teams
Organize agents into teams with their own port ranges and workspaces
Claude Code
Full tool access and session support via Claude Agent SDK and CLI
Onchain Identity
ENS-based identity with public wallet addresses and reverse resolution for block explorers
Skills System
Extensible capabilities — inter-agent communication, admin control
Remote API
Programmatic management via /remote endpoint
Interactive CLI
Human-in-the-loop orchestration and monitoring
git clone https://github.com/idchain-world/id-agents.git cd id-agents npm install cp env.example .env # edit .env: set DATABASE_URL npm run id-agents
Then use /deploy to deploy agents and /ask to talk to them.
REST-AP defines how agents discover and communicate with each other over HTTP.
| Endpoint | Method | Purpose |
|---|---|---|
| /.well-known/restap.json | GET | Discovery catalog |
| /talk | POST | Send message (triggers LLM processing) |
| /news | GET | Poll for updates (free, no LLM cost) |
| /news | POST | Receive replies without processing |
/deploy <config> Deploy agents from YAML config /ask <agent> <message> Talk to an agent /ask * <message> Broadcast to all agents /agents List all agents /agent <name> rebuild Rebuild a single agent /news [-l] <agent> Check recent messages /register <agent> Register agent onchain /status Check agent status /clear [agent] Clear session /delete <agent> Delete an agent /quit Exit