Spawns, configures, and registers new HyperCode agents into the Crew Orchestrator. Use when user asks to create a new agent, add a specialist to the system, or when Agent X needs to deploy a new capability. Handles agent spec creation, Docker service wiring, and Redis pub/sub registration automatically.
Note:
scripts/spawn_agent.pyis not yet implemented. Use the manual steps below — they're fast and give you full control.
Every agent MUST have these fields in its spec JSON at agents/<name>/agent_spec.json:
{
"name": "agent-name",
"role": "specialist description",
"port": 8XXX,
"tools": ["tool1", "tool2"],
"memory": "redis|postgres|none",
"safety_level": "strict|moderate|open",
"auto_evolve": true
}
mkdir -p agents/<name>agents/<name>/agent_spec.jsonagents/<name>/main.py using the pattern in CONTRIBUTING.md./agents, dockerfile <name>/Dockerfiledocker-compose.yml under correct profileagents:heartbeat:<name> Redis HSET in startup (30s TTL, 10s interval)r.publish('hypercode:agents:register', json.dumps(spec))curl http://localhost:<port>/healthTaken: 3000, 3001, 6379, 5432, 8000, 8008, 8080, 8081, 8088, 8091, 8092, 8093 Use: 8094+ for new agents
Agent Teams (Claude Opus 4.6 style): See AGENT_TEAMS.md Safety limits: See SAFETY.md