Emulo — Claude Code MCP server: extract your coding rules from sessions
Emulo parses your AI coding session logs and builds a you.md profile with your actual working rules — each one tied to a date and your own message. Your agent can read it and work your way from the start.
MIT ★ 306 updated 2026-10-12
claude mcp add emulo -- uvx emuloWhat emulo does
Emulo reads raw logs from Claude Code, Codex, Copilot CLI, OpenCode and similar platforms to find the patterns you live by: what you reject on sight, what "done" means, how you debug, how you write UI. Each rule in the profile carries a timestamp and a quote from your chat — it is not a template, it is what actually worked.
The profile splits into layers: work, design, writing, and video. A host loads only the layer that fits the task. Emulo does not claim the profile will make your agent work better (that is hard to measure), but in September 2026 tests it changed model output on real tasks. Support varies by platform: in Codex the profile reaches the model through AGENTS.md, in Claude Code you type /you to load it by hand, in Cursor and Gemini the file lands where they look for it.
Installing the server and actually loading the profile are separate steps. Python with no external dependencies is all you need. Run the mine command, select what to include from your logs, and the profile builds on your machine. If you point mining at a remote model, selected evidence goes there; a local model keeps everything local.
What it helps with
- extract coding rules and patterns from your chat history with agents
- build a dated profile with real examples instead of generic templates
- give your agent context about how you work and what you reject
- split rules by work type — code, design, video, writing
- load the profile into your IDE so the model can read it
Example prompts for the agent
- Run
/emulo:minein Claude Code, pick your session logs, and choose which parts to add to the profile. - After
/plugin install emulo@emuloin Codex, callemulo:mine, point it at your log folder, and let it build the profile. - Run
emulo:minewith a local model to keep the whole process on your machine, then copyyou.mdinto your project.
How to install emulo
Platform CLI
claude mcp add emulo -- uvx emulouvx runs the command named after the package; if the README names another one, use uvx --from emulo <command>
Platform CLI
codex mcp add emulo -- uvx emulouvx runs the command named after the package; if the README names another one, use uvx --from emulo <command>
Config file
{
"mcpServers": {
"emulo": {
"command": "uvx",
"args": [
"emulo"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from emulo <command>
Config file
{
"servers": {
"emulo": {
"type": "stdio",
"command": "uvx",
"args": [
"emulo"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from emulo <command>
Platform CLI
gemini mcp add emulo uvx emulouvx runs the command named after the package; if the README names another one, use uvx --from emulo <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about emulo
How do I install Emulo in Claude Code?
Run /plugin marketplace add ohad6k/emulo first, then /plugin install emulo@emulo.
What does Emulo do?
Emulo reads logs from your sessions with coding agents, finds the real rules buried in your messages (what you turn down, what you mean by done, how you trace bugs), and creates a you.md profile with dated quotes. An agent can read that profile and work your way.
Does Emulo need Python libraries installed?
No. Emulo is written in Python with zero external dependencies and runs wherever Python is available.