ID Agents#

ID Agents is multi-agent orchestration software supporting both the Claude Agent SDK and Claude Code CLI. It enables autonomous AI agents to run as local processes, coordinate as teams, and optionally register onchain for verifiable identity.

Key Features#

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
Teams -- Organize agents into teams with their own port ranges and workspaces
Claude Code -- Runs on Claude Code with full tool access and session support
Onchain identity -- ENS-based identity with public wallet addresses, multi-chain address management, and reverse resolution so your agent name shows up in block explorers
Remote API -- Programmatic management via the /remote endpoint
Skills system -- Extensible capabilities including inter-agent communication, admin control, and memory

Architecture#

ID Agents uses a manager-worker architecture. The Manager acts as the central coordinator, spawning and tracking agents. Each Worker is an independent local process running a Claude agent with its own REST-AP server.

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│                        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)  │
   │               │   │               │   │               │
   └───────────────┘   └───────────────┘   └───────────────┘

Core components:

Component	Source	Purpose
Manager	`src/agent-manager-db.ts`	DB-backed API, agent registry, orchestration logic, `/remote` endpoint
Worker	`src/claude-agent-server.ts`	REST-AP server running Claude in each agent process
Local Agent Server	`src/local-agent-server.ts`	Spawns and manages local agent processes

How It Works#

Start the manager -- The interactive CLI launches the manager on port 4100 (configurable).
Deploy agents -- Use /deploy with a YAML config to spin up one or more agents. Each agent gets its own port, workspace, and REST-AP endpoints.
Communicate -- Send messages to agents via /ask or the REST-AP /talk endpoint. Agents process requests asynchronously and return results through /news.
Coordinate -- Agents can discover and talk to each other using the inter-agent communication skill and REST-AP endpoints.
Register onchain -- Optionally register agents on ID Chain for permanent, verifiable ENS-based identity.

Ports and Networking#

Component	Port	Description
Manager	4100	Main API and `/remote` endpoint
Workers	4101+	Dynamic per-team range (25 ports per team)
PostgreSQL	5432	Database

License#

ID Agents is licensed under the MIT License. See LICENSE for the full text.

Note: ID Agents switched from GPL-3.0 to the MIT License on March 24, 2026.

Next Steps#

Quick Start -- Get up and running in minutes
CLI Reference -- Full list of commands
REST-AP Protocol -- How agents communicate
Configuration -- YAML config and environment variables
Skills -- Extend agent capabilities
Onchain Identity -- Register agents on ID Chain