Skip to content

Commit c72d357

Browse files
autogame-17claude
andcommitted
feat: Evolver — official Claude Code plugin + evomap marketplace
GEP self-evolution for Claude Code: session hooks (memory inject / signal detect / outcome record), zero-dep MCP bridge to the EvoMap Proxy mailbox (genes & capsules), 7 slash commands, evolution-loop skill, strategist agent. Verified with 'claude plugin validate' and a real --plugin-dir load. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
0 parents  commit c72d357

22 files changed

Lines changed: 1682 additions & 0 deletions

.claude-plugin/marketplace.json

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
{
2+
"name": "evomap",
3+
"description": "Official Claude Code marketplace for EvoMap — home of Evolver, the GEP-powered self-evolution engine for AI agents.",
4+
"owner": {
5+
"name": "EvoMap",
6+
"email": "team@evomap.ai",
7+
"url": "https://evomap.ai"
8+
},
9+
"version": "0.1.0",
10+
"metadata": {
11+
"pluginRoot": "./plugins"
12+
},
13+
"plugins": [
14+
{
15+
"name": "evolver",
16+
"source": "./plugins/evolver",
17+
"displayName": "Evolver",
18+
"description": "Self-evolution for your Claude Code agent: auto-injects past evolution memory, detects evolution signals while you work, records outcomes, and exposes the EvoMap Proxy mailbox (genes & capsules) as MCP tools and slash commands.",
19+
"version": "0.1.0",
20+
"author": { "name": "EvoMap", "email": "team@evomap.ai", "url": "https://evomap.ai" },
21+
"homepage": "https://evomap.ai",
22+
"repository": "https://github.com/EvoMap/evolver",
23+
"license": "GPL-3.0-or-later",
24+
"category": "ai",
25+
"keywords": ["evomap", "evolution", "gep", "self-improvement", "meta-learning", "agent", "ai", "memory"],
26+
"strict": true
27+
}
28+
]
29+
}

.gitignore

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
node_modules/
2+
.DS_Store
3+
*.log
4+
.env
5+
.env.*
6+
!.env.example

README.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# EvoMap — Claude Code marketplace
2+
3+
Official [Claude Code](https://claude.com/claude-code) plugin marketplace for [EvoMap](https://evomap.ai).
4+
5+
## Plugins
6+
7+
| Plugin | Description |
8+
|--------|-------------|
9+
| [**evolver**](plugins/evolver) | Self-evolution for your Claude Code agent — auto-recall of past outcomes, signal detection, outcome recording, and an MCP bridge to the EvoMap Proxy (genes & capsules). Powered by [`@evomap/evolver`](https://github.com/EvoMap/evolver). |
10+
11+
## Install
12+
13+
```text
14+
/plugin marketplace add EvoMap/evolver-plugin # or a local path to this repo
15+
/plugin install evolver@evomap
16+
```
17+
18+
Then restart Claude Code so hooks and the MCP server load. See [plugins/evolver/README.md](plugins/evolver/README.md) for prerequisites, configuration, and usage.
19+
20+
## Develop locally
21+
22+
```bash
23+
# Validate the marketplace and plugin
24+
claude plugin validate .
25+
26+
# Try the plugin without installing (loads it directly)
27+
claude --plugin-dir ./plugins/evolver
28+
```
29+
30+
## License
31+
32+
The Evolver plugin is GPL-3.0-or-later, matching the upstream engine. See [plugins/evolver/LICENSE](plugins/evolver/LICENSE).
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
{
2+
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
3+
"name": "evolver",
4+
"displayName": "Evolver",
5+
"version": "0.1.0",
6+
"description": "Self-evolution for your Claude Code agent. Auto-injects recent evolution memory at session start, detects evolution signals while you edit, records session outcomes, and bridges the EvoMap Proxy mailbox (genes & capsules) into Claude via MCP tools and slash commands. Powered by @evomap/evolver.",
7+
"author": {
8+
"name": "EvoMap",
9+
"email": "team@evomap.ai",
10+
"url": "https://evomap.ai"
11+
},
12+
"homepage": "https://evomap.ai",
13+
"repository": "https://github.com/EvoMap/evolver",
14+
"license": "GPL-3.0-or-later",
15+
"keywords": [
16+
"evomap",
17+
"evolution",
18+
"gep",
19+
"self-improvement",
20+
"meta-learning",
21+
"agent",
22+
"ai",
23+
"memory"
24+
],
25+
"userConfig": {
26+
"node_id": {
27+
"type": "string",
28+
"title": "EvoMap Node ID (A2A_NODE_ID)",
29+
"description": "Your EvoMap node identity. Leave blank to let the Proxy register one on first run.",
30+
"default": ""
31+
},
32+
"hub_url": {
33+
"type": "string",
34+
"title": "EvoMap Hub URL (A2A_HUB_URL)",
35+
"description": "Base URL of the EvoMap Hub the Proxy talks to.",
36+
"default": "https://evomap.ai"
37+
},
38+
"proxy_port": {
39+
"type": "string",
40+
"title": "Proxy port (EVOMAP_PROXY_PORT)",
41+
"description": "Local Proxy mailbox port that the MCP bridge connects to.",
42+
"default": "19820"
43+
},
44+
"strategy": {
45+
"type": "string",
46+
"title": "Evolution strategy (EVOLVE_STRATEGY)",
47+
"description": "balanced | innovate | harden | repair-only | early-stabilize | steady-state | auto",
48+
"default": "balanced"
49+
}
50+
}
51+
}

plugins/evolver/.mcp.json

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
{
2+
"mcpServers": {
3+
"evolver-proxy": {
4+
"command": "node",
5+
"args": ["${CLAUDE_PLUGIN_ROOT}/mcp/evolver-proxy.mjs"],
6+
"env": {
7+
"EVOMAP_PROXY_PORT": "${user_config.proxy_port}",
8+
"A2A_HUB_URL": "${user_config.hub_url}",
9+
"A2A_NODE_ID": "${user_config.node_id}"
10+
}
11+
}
12+
}
13+
}

plugins/evolver/CHANGELOG.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Changelog
2+
3+
All notable changes to the Evolver Claude Code plugin are documented here.
4+
This project adheres to [Semantic Versioning](https://semver.org/).
5+
6+
## [0.1.0] — 2026-06-04
7+
8+
Initial release. Packages Evolver's Claude Code integration as an installable plugin.
9+
10+
### Added
11+
- **Hooks** (`hooks/hooks.json` + bundled, dependency-free scripts):
12+
- `SessionStart` → inject recent evolution outcomes as context.
13+
- `PostToolUse` (Write/Edit/MultiEdit) → detect evolution signals in edits.
14+
- `Stop` → record a git-diff-derived outcome to the EvoMap Hub or local memory.
15+
- Evolution memory standardized under `~/.evolver/memory/evolution/memory_graph.jsonl` so the loop is self-contained (no dependence on the engine source tree).
16+
- **MCP bridge** `evolver-proxy` (zero-dependency stdio server): `evolver_status`, `evolver_search_assets`, `evolver_fetch_asset`, `evolver_publish_asset`, `evolver_poll`.
17+
- **Slash commands**: `/evolver:run`, `/evolver:solidify`, `/evolver:review`, `/evolver:sync`, `/evolver:distill`, `/evolver:search`, `/evolver:status`.
18+
- **Skill** `evolution-loop` (model-invoked) and **subagent** `evolution-strategist`.
19+
- `userConfig` for node id, hub URL, proxy port, and default strategy.
20+
21+
### Notes
22+
- Active commands use a global `evolver` CLI when present and fall back to `npx -y @evomap/evolver`.
23+
- Compatible with `@evomap/evolver` ≥ 1.80.

0 commit comments

Comments
 (0)