Skip to content

Commit 70aac00

Browse files
committed
Enhance Evolver Codex plugin with MCP bridge
1 parent 14c75d8 commit 70aac00

8 files changed

Lines changed: 1057 additions & 36 deletions

File tree

README.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
1-
# Evolver Codex Plugin
1+
# EvoMap Codex plugin marketplace
22

3-
Private EvoMap marketplace repository for the Evolver Codex Desktop plugin.
3+
Internal EvoMap marketplace repository for the official Evolver Codex Desktop plugin.
4+
5+
## Plugins
6+
7+
| Plugin | Description |
8+
| --- | --- |
9+
| [**evolver**](plugins/evolver) | Self-evolution workflows for Codex Desktop: GEP guidance, Evolver CLI setup, and an MCP bridge to the EvoMap Proxy mailbox for Genes and Capsules. Powered by [`@evomap/evolver`](https://github.com/EvoMap/evolver). |
410

511
## Install
612

@@ -18,15 +24,20 @@ codex plugin add evolver@evomap-private
1824

1925
Start a new Codex thread after installation so the bundled skill is loaded.
2026

21-
## Plugin
27+
## Develop locally
2228

23-
The plugin lives at:
29+
```bash
30+
# Validate the plugin manifest and skills
31+
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/evolver
2432

25-
```text
26-
plugins/evolver
33+
# Try the marketplace from this checkout
34+
codex plugin marketplace add /Users/seikiko/evolver-codex-plugin
35+
codex plugin add evolver@evomap-private
2736
```
2837

29-
It packages a Codex skill for using Evolver, EvoMap's GEP-powered self-evolution engine, from Codex Desktop.
38+
## License
39+
40+
The Evolver plugin is GPL-3.0-or-later, matching the upstream engine. See [plugins/evolver/LICENSE](plugins/evolver/LICENSE).
3041

3142
Official Evolver sources:
3243

plugins/evolver/.codex-plugin/plugin.json

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "evolver",
3-
"version": "0.1.0",
4-
"description": "Official Codex Desktop plugin for the Evolver GEP-powered self-evolution engine.",
3+
"version": "0.2.0",
4+
"description": "Official Codex Desktop plugin for Evolver: GEP workflows, local Proxy MCP tools, and auditable agent self-evolution.",
55
"author": {
66
"name": "EvoMap",
77
"email": "team@evomap.ai",
@@ -19,10 +19,11 @@
1919
"codex"
2020
],
2121
"skills": "./skills/",
22+
"mcpServers": "./.mcp.json",
2223
"interface": {
2324
"displayName": "Evolver",
24-
"shortDescription": "Run Evolver's GEP workflow from Codex.",
25-
"longDescription": "Evolver is EvoMap's GEP-powered self-evolution engine for AI agents. This Codex Desktop plugin teaches Codex how to install, verify, and use the official @evomap/evolver CLI in git workspaces, including review mode, strategy presets, Codex hook setup, local GEP assets, and optional EvoMap Hub configuration.",
25+
"shortDescription": "Use Evolver GEP workflows and Proxy tools from Codex.",
26+
"longDescription": "Evolver is EvoMap's GEP-powered self-evolution engine for AI agents. This Codex Desktop plugin bundles a skill plus an MCP bridge to the local Evolver Proxy mailbox, helping Codex reuse Genes and Capsules, check Proxy status, run review-oriented evolution workflows in git workspaces, configure Codex hooks, and keep local evolution memory auditable.",
2627
"developerName": "EvoMap",
2728
"category": "Productivity",
2829
"capabilities": [
@@ -32,9 +33,9 @@
3233
],
3334
"websiteURL": "https://evomap.ai",
3435
"defaultPrompt": [
35-
"Set up Evolver for this Codex workspace.",
36-
"Run Evolver review mode and explain the GEP output.",
37-
"Check whether Evolver is installed correctly."
36+
"Check Evolver Proxy status for this workspace.",
37+
"Search EvoMap Genes before changing this repo.",
38+
"Run Evolver review mode and explain the GEP output."
3839
],
3940
"brandColor": "#2F855A",
4041
"composerIcon": "./assets/evolver-icon.png",

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": ["./mcp/evolver-proxy.mjs"],
6+
"cwd": ".",
7+
"env": {
8+
"EVOMAP_PROXY_PORT": "19820",
9+
"A2A_HUB_URL": "https://evomap.ai"
10+
}
11+
}
12+
}
13+
}

plugins/evolver/CHANGELOG.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Changelog
2+
3+
All notable changes to the Evolver Codex Desktop plugin are documented here.
4+
This project follows Semantic Versioning.
5+
6+
## [0.2.0] - 2026-06-04
7+
8+
### Added
9+
10+
- Bundled MCP bridge `evolver-proxy`, adapted from the official Evolver Claude Code plugin, exposing local Proxy mailbox tools for status, asset search, asset fetch, asset publishing, and mailbox polling.
11+
- Codex plugin MCP manifest at `.mcp.json`.
12+
- GPL-3.0-or-later license file, matching the upstream Evolver engine.
13+
- Expanded Codex skill guidance for passive recall, active control, Proxy/MCP usage, Hub configuration, and safety boundaries.
14+
- Polished README with install, configure, verify, and troubleshooting sections.
15+
16+
### Changed
17+
18+
- Improved plugin manifest metadata and prompts to match the richer Evolver integration model.
19+
- Kept Claude-specific hooks and slash commands out of the Codex plugin because Codex does not ingest Claude plugin `hooks/` or `commands/` directories.
20+
21+
## [0.1.0] - 2026-06-04
22+
23+
### Added
24+
25+
- Initial Codex Desktop plugin scaffold for Evolver.
26+
- Evolver skill, icon/logo assets, helper status script, and repo-scoped marketplace entry.

0 commit comments

Comments
 (0)