ECX: Everything Claude Codex

At a glance

ECX is an MIT-licensed bundle of hooks, skills and local Python services that turns Claude Code (and optionally OpenAI's Codex) into a personal note-and-memory system. Both agents boot from the same hot.md memory file, a hook feeds each one the other's newest chat lines, and a notes vault becomes searchable through three MCP servers (search by meaning, a knowledge graph, and a router that picks between them) plus a separate CLIP indexer for images. It suits someone willing to adopt one author's whole workflow, not someone looking for a single add-on.

Good fit

Developers who already use Claude Code daily, keep notes in an Obsidian-style vault, and want sessions to start with their deadlines and recent context loaded. It fits best if you also use Codex and want to start a task in one agent and finish it in the other, or want to capture notes by voice from a phone through a private GitHub repo.

Consider something else when

Skip it if you want one feature, such as a danger guard or a tests-before-done check, without a vault, eighteen skills and session-start hooks wired into your settings. Also skip it if note text must never leave your machine and you do not plan to point the graph indexer at a local Ollama model, or if you need a project with a track record: the repository was created on 28 October 2026.

Start here

Clone the repository to ~/ecx and run ./install.sh. It asks where your notes live and your first name, then links the skills and registers hooks, saving a .ecx-bak copy of each settings file it changes. Open Claude Code inside your vault and type /boot; a short briefing means memory loaded. Add --with-search, --with-cron and --with-phone later for search, nightly indexing and phone sync.

Cost and requirements

The code is free under the MIT licence. You need Python 3.9 or later and Claude Code; Codex is optional, since everything except agent-sync works with Claude Code alone. Search relies on ChromaDB, a LightRAG graph and CLIP, and the graph uses Ollama. Phone mode needs a private GitHub repo plus the Claude or ChatGPT mobile app. Any subscription costs for those agents are separate and not stated.

Limits to know

Per the README, the relationship graph's default model runs on Ollama's free cloud, so note text is sent there during indexing unless ECX_LLM_MODEL names a local model. Phone mode pushes notes and a memory copy to GitHub after every reply. The tests-before-done hook gives up after three failed attempts. The AI-tell guard warns on em dashes and listed phrases and can fire on human prose. Removal is manual: restore .ecx-bak files and delete the skill links.

Related work

• Superpowers, a skills pack ECX runs alongside rather than replaces (complement)
• Claude Code, the agent ECX's hooks, skills and memory files are built around (context)
• Obsidian, the note vault format ECX's search and memory can index (complement)

Still unclear

• How agent-sync reads Codex chats and voice transcripts, and whether it breaks when either agent changes its local log format.
• Which files and settings the installer modifies outside the vault and ~/.claude, and how the session-start doctor run affects startup time.