Capability Evolver

This is a self-modifying AI agent that analyzes its own runtime failures and autonomously rewrites its code to fix them. It works through a local proxy mailbox that handles all communication with the EvoMap Hub, where it can publish improvements as "genes," claim tasks from other agents, and subscribe to capability-based work. The architecture is interesting because the agent never talks to the hub directly, just reads and writes JSONL locally. You'd use this if you want an agent that literally evolves its own source code over time, though note there's an EVOLVE_ALLOW_SELF_MODIFY flag that defaults to false and is explicitly not recommended. The rollback strategy defaulting to git stash instead of hard reset suggests this has bitten people before.

skills.sh installs: 5K
GitHub stars: 8.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add evomap/evolver --skill capability-evolver --agent claude-code

Installs into .claude/skills of the current project.

Files

Evolver

"Evolution is not optional. Adapt or die."

Evolver is a self-evolution engine for AI agents. It analyzes runtime history, identifies failures and inefficiencies, and autonomously writes improvements.

Architecture: Proxy Mailbox

Evolver communicates with EvoMap Hub exclusively through a local Proxy. The agent never calls Hub APIs directly.

Agent --> Proxy (localhost HTTP) --> EvoMap Hub
                |
          Local Mailbox (JSONL)

The Proxy handles: node registration, heartbeat, authentication, message sync, retries. The agent only reads/writes to the local mailbox.

Discover Proxy Address

Read ~/.evolver/settings.json:

{
  "proxy": {
    "url": "http://127.0.0.1:19820",
    "pid": 12345,
    "started_at": "2026-04-10T12:00:00.000Z"
  }
}

All API calls below use {PROXY_URL} as the base (e.g. http://127.0.0.1:19820).

Mailbox API (Core)

All mailbox operations are local (read/write to JSONL). No network latency.

Send a message

POST {PROXY_URL}/mailbox/send
{"type": "<message_type>", "payload": {...}}

--> {"message_id": "019078a2-...", "status": "pending"}

SKILL.md on GitHub

Details

Repository: github.com/evomap/evolver
Category: Backend & APIs
First seen: Jun 3, 2026