Install any skill in seconds. Free to start, no credit card required.
Get Started Free →sonichi/agent-registry
Local Agent Registry — a standalone, dependency-free service that tracks running Claude Code (and other) agent instances. Agents self-register on startup and heartbeat while alive; the Electron overlay and Sutando dashboard read the live list.
Passed 16 of 21 test cases with the skill, and 6 of 21 without it.
and 11 more in the full report
11 fixed6 passed either way5 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 11 test cases the skill fixed. Same model, same prompt, with and without the skill.
I want to manually register a process named 'worker-1' with PID 1234 using the registry CLI without starting a watch daemon. What exact CLI command should I run?
| Checked | Without skill | With skill |
|---|---|---|
| Executes "python3 skills/agent-registry/scripts/registry-client.py register --name worker-1 --pid 1234" | Missed | Passed |
The instructions your model reads when the skill loads.
A thin local service that tracks running agent instances. Claude Code instances register themselves on startup (via a SessionStart hook) and heartbeat while alive; consumers read the live list over a localhost HTTP API.
This is not the AG2 Workforce Hub app. It is a small local service that can
optionally mirror its state to an AG2 hub using the hub connection layer
(ag2_workforce.hub.client) — see "Optional: AG2 Hub mirroring" below — but the
core service has zero third-party dependencies and works entirely offline.
skills/agent-registry/
├── scripts/registry-service.py # the HTTP service + SQLite store
├── scripts/registry-client.py # CLI: register / heartbeat / deregister / list / watch
└── hooks/session-start.sh # Claude Code SessionStart hook
<workspace>/data/agent-registry.db (SQLite, auto-created)<workspace>/state/agent-registry.json — written by the
service with the bound port so clients find it without a hardcoded port.127.0.0.1, first free port from 7847 upward.It is startable by Sutando three ways, in order of preference:
registry-client.py call with --autostart
launches the service detached if it is not already running. The
SessionStart hook passes --autostart, so the first Claude Code session to
start brings the registry up.startup.sh. For an always-on registry, add to src/startup.sh:
python3 skills/agent-registry/scripts/registry-service.py &python3 skills/agent-registry/scripts/registry-service.pyAdd the SessionStart hook to .claude/settings.json:
test cases passed, vs 6 / 21 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.