ECX: Unified Memory Setup for Claude Code and Codex Agents
A productivity framework enabling synchronized memory and cross-agent communication for AI coding assistants.
1Unified AI Agent Architecture
ECX is a framework designed to synchronize Claude Code and Codex agents by providing them with a shared memory space. By enabling these agents to read the same files and exchange messages, users can start tasks in one interface and seamlessly continue them in another without repeating context or instructions.
2Shared Memory and Synchronization
The system utilizes a hot.md file to maintain current project state, deadlines, and rules. Before every message, hooks inject the latest chat lines from one agent into the other. This bidirectional sync ensures that both agents remain aware of the user's progress, including voice transcripts provided to the Codex agent.
3Advanced Search Capabilities
ECX integrates three distinct search engines to manage user knowledge. It supports semantic search via ChromaDB, relationship mapping through LightRAG graphs, and image-based retrieval using CLIP. These tools allow users to query notes by meaning or describe visual elements in slides and screenshots to locate specific information across their vault.
4Mobile Access via GitHub
The setup uses a private GitHub repository as a bridge, allowing users to interact with their AI agents while their laptop is shut. Captures or voice notes sent from a phone are automatically merged into the vault. This ensures that ideas are filed and synced without requiring a dedicated server.
5Proactive Health and Safety
The system includes over 16 doctor checks that run at the start of every session to identify broken dependencies. A danger guard prevents destructive commands like file deletions or forced pushes. Additionally, an AI-tell guard flags generic AI phrasing in personal content to maintain a more natural writing style.
6Automated Testing Protocols
ECX enforces strict quality control by running 27 automated tests before an agent can mark a task as done. If tests fail, the agent receives the error output and must attempt a fix. The system supports various environments, including npm, pytest, and cargo, ensuring code reliability before final commits are made.
7Deployment and Installation
Installation is designed to be completed in 30 seconds via a git clone and a shell script. The setup is non-destructive, as it never overwrites existing configuration files and creates backups of any settings it modifies. It is compatible with both macOS and Linux environments using Python 3.9 through 3.12.
8Extensible Skill Framework
The framework includes 18 pre-built skills such as daily briefings, opportunity pipelines, and content generation tools. Users can extend the system by adding custom hooks or skills in the designated directories. The architecture is modular, allowing it to run alongside other existing agent packs like Superpowers without causing conflicts.
9Operational Impact and Utility
Developed over six months, this setup has powered 37 shipped projects. By automating session initialization, health monitoring, and cross-agent communication, ECX reduces the cognitive load on developers. It transforms disparate AI tools into a cohesive, persistent workspace that maintains context and reliability across different devices and long-term project lifecycles.
Original article: Hacker News: Show HN — ECX: Unified Memory Setup for Claude Code and Codex Agents