Skip to content

feat(plugin): add ReMe integration for Codex - #399

Open
RerankerGuo wants to merge 2 commits into
agentscope-ai:mainfrom
RerankerGuo:feat/issue-350-codex-plugin
Open

feat(plugin): add ReMe integration for Codex#399
RerankerGuo wants to merge 2 commits into
agentscope-ai:mainfrom
RerankerGuo:feat/issue-350-codex-plugin

Conversation

@RerankerGuo

Copy link
Copy Markdown
Contributor

Summary

This PR addresses #350 by adding a complete ReMe plugin for Codex, following the same architecture as the existing Claude Code plugin.

Changes

New: plugins/codex/ directory structure

  • .codex-plugin/plugin.json — Codex plugin manifest with metadata
  • reme/.mcp.json — MCP server connection configuration (streamable-http)
  • reme/hooks/hooks.json — Stop hook configuration for session recording
  • reme/hooks/auto_memory.py — Fire-and-forget session recording hook that calls auto_memory_cc
  • reme/skills/reme-memory/SKILL.md — Memory recall skill with semantic/topological/state patterns
  • README.md — Installation, configuration, and troubleshooting guide

Architecture

The plugin follows the same proven design as the Claude Code plugin:

  1. Shared MCP Server: Connects to a separately running ReMe MCP server (does not spawn ReMe)
  2. Stop Hook: Automatically records sessions via detached background process (best-effort)
  3. Memory Skill: Provides recall patterns (semantic search, topological traverse, state listing)
  4. Server Status: Health check pattern for verifying ReMe connectivity

Differences from Claude Code plugin

  • Uses CODEX_PLUGIN_ROOT env var instead of CLAUDE_PLUGIN_ROOT
  • Hook configuration adapted for Codex hook conventions
  • Skill description tailored for Codex context

Testing

  • Plugin structure follows existing patterns (Claude Code plugin as reference)
  • MCP client logic (auto_memory.py) is shared/adapted from Claude Code plugin
  • SKILL.md recall patterns verified against ReMe tool names
  • Configuration keys match ReMe MCP service defaults
  • Integration test (requires Codex runtime; manual verification recommended)

Checklist

  • Plugin files follow existing naming and structure conventions
  • Stop hook is fire-and-forget with proper error handling
  • SKILL.md provides clear recall guidance for LLM consumers
  • README includes installation and troubleshooting steps
  • No breaking changes to existing code

Closes agentscope-ai#350
- Add plugins/codex/ with complete plugin structure:
  - .codex-plugin/plugin.json: Codex plugin manifest
  - reme/.mcp.json: MCP server connection config
  - reme/hooks/hooks.json: Stop hook configuration
  - reme/hooks/auto_memory.py: Session recording hook
  - reme/skills/reme-memory/SKILL.md: Memory recall skill
  - README.md: Installation and troubleshooting guide
- Plugin follows the same architecture as the Claude Code plugin:
  - Connects to a shared ReMe MCP server (streamable-http)
  - Stop hook auto-records sessions via auto_memory_cc
  - SKILL.md provides recall patterns (semantic, topological, state)
  - Best-effort recording with daemonized execution
- Uses CODEX_PLUGIN_ROOT env var (vs CLAUDE_PLUGIN_ROOT)
- Supports REME_HOST/REME_PORT env overrides

Test: not run (requires Codex runtime for integration testing)
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@CLAassistant

CLAassistant commented Jul 28, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@jinliyl
jinliyl requested a review from ployts July 29, 2026 02:20
Auto-formatting fix required by add-trailing-comma pre-commit hook.
@RerankerGuo
RerankerGuo force-pushed the feat/issue-350-codex-plugin branch from 6879123 to d1dd9ec Compare July 30, 2026 00:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants