[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_129":130},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":-5,"_55":47,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":47,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90},"apiUrl","https://odel.app/api","creator","ohad6k","moduleId","emulo","@ohad6k/emulo","displayName","tagline","Mine your local AI coding session logs into a profile your agent loads before every task.","iconKey","https://avatars.githubusercontent.com/u/190882507?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1784262763000,"updatedAt",1788237589000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.ohad6k%2Femulo","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",280,"upstreamUpdatedAt",1787596247000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/ohad6k/emulo","githubRepoFullName","ohad6k/emulo","releaseId","ext-ohad6k-emulo","version","0.6.2","descriptionMarkdown","\n

$\"Emulo\"$

\n\n

Emulo

\n\n

Your AI agents act like they just met you. Emulo fixes that.

\n\n

\n $\"stars\"$ \n $\"discord\"$ \n $\"MIT\"$ \n $\"Python,$ \n $\"works$ \n

\n\nYour real coding-agent sessions already contain the rules you never wrote down: what “done” means, what you reject on sight, how you debug, how you design UI, and how you write when you are actually working.\n\nEmulo mines selected evidence from those sessions — Claude Code, Codex, Copilot CLI, OpenCode, and Google Antigravity logs out of the box — into a private working profile your agent reads before every task. Separate layers for work, design, writing, and video mean the right part of you loads for the right task.\n\nThe mined profile loads where your agents already live: Claude Code and Codex natively, Cursor, Gemini, and OpenCode through explicit adapters, and OpenClaw and Hermes Agent as a standard skill ([guide](https://github.com/ohad6k/emulo/blob/main/docs/OPENCLAW_HERMES.md)).\n\nThe [Emulo Proof v1 methodology](https://github.com/ohad6k/emulo/blob/main/docs/proof/README.md) is an unexecuted methodology until a separately approved evidence release exists.\n\n## The video layer, and where it comes from\n\n

$\"A$

\n\nA spec commercial, made in Claude Design. No After Effects and no motion software:\nthe whole thing is a composition rendered out to video.\n\nIt is **spec work**. It was not commissioned by Vercel and it was not made for\nthem. A brand was picked to see how far the motion could go.\n\nIt is here because `emulo:video` is mined from sessions like the one that\nproduced it. The other layers work the same way: the profile is not a template,\nit is what survived from real work.\n\n## Install\n\nInside Claude Code:\n\n```text\n/plugin marketplace add ohad6k/emulo\n/plugin install emulo@emulo\n```\n\nInside Codex:\n\n```bash\ncodex plugin marketplace add ohad6k/emulo --ref v0.6.2 --json\ncodex plugin add emulo@emulo --json\n```\n\nThen run `emulo:mine` and point it at your session history. Everything below explains what that produces and why. If you want the CLI instead of the plugin, see [Quickstart](#quickstart).\n\n## Open source and privacy\n\nEmulo is MIT licensed, free, and works without an account. There is nothing to\nbuy and no sign-in.\n\nSession extraction, redaction, caches, the profile itself, and the agent\nadapters all stay on your machine. The one exception is mining: if you point it\nat a hosted model, the selected evidence goes to that provider. Point it at a\nlocal model and the whole run stays on your machine.\n\n## Not memory\n\nMemory is what you explicitly told the model.\n\nEmulo mines what your work already proved about you: what you reject, what \"done\" means, when you ask for proof, how you talk when you're actually working, and the agent behaviors that make you stop the task.\n\nThat's why it reads raw session logs, not your `CLAUDE.md` or rules file.\n\n## A real run\n\nOne line to the same agent, twice: **\"help me post emulo on reddit.\"** Once cold, once with the Emulo profile loaded.\n\n\n\n\n\n\n\n\n\n\n

🡒 agent	🡒 agent + emulo
\n\nHere's how I'd play it.\n\nSubreddits: r/ClaudeAI and r/ChatGPTCoding are your core audience. r/LocalLLaMA fits the local angle. r/cursor, r/SideProject, r/opensource for reach. Don't blast all at once — post to one, tune the title, repost over a few days.\n\nTitle: I built a local tool that reads your AI coding logs and writes a \"you.md\" your agents read before every task\n\n \n full reply \n\nTitles (pick per sub):\n- I built a local tool that reads your AI coding logs and writes a \"you.md\" your agents read before every task\n- emulo: mine your own Claude Code history into a profile so your agent codes like you (local, open source)\n\nBody:\n> Every fresh agent session starts from zero — it doesn't know how you work, so you re-explain yourself every time. All of that is already in your session logs. So I built emulo: it reads your history, mines how you decide and talk, and writes a `you.md` your agents read before every task.\n> - runs locally, your logs never leave your machine\n> - redacts secrets before processing\n> - open source: [link]\n\nAlso: open with the pain not the product, reply fast in the first hour, add a demo gif, and flair it correctly. Want me to write tuned variants for each subreddit?\n\n \n	\n\nthe insight first: the mining number is your whole post. \"i read 1,656 of my own sessions\" is a confession, not a pitch, and nobody scrolls past a confession. lead with the mirror, not the mechanism.\n\none sub, not five — a skills sub, where people come looking for this instead of arguing about it.\n\nTitle: I built a Claude skill from 8 months of my own Claude Code sessions\n\n \n the full post it wrote \n\nbody: I use claude code and codex every day. 8 months, solo. every session gets logged and i never really looked back at them.\n\nthen it hit me that those logs are probably the most honest record of how i actually work. not my CLAUDE.md, not my docs, not the rules i remembered to write down. the real sessions.\n\nso i built emulo.\n\nWhat I did: pulled every message i typed from my local claude/codex logs. stripped tool output, pasted errors, file dumps, and assistant replies. kept only my words. came out to around 1,656 sessions and almost 3M tokens of just me.\n\nthen i split it into chunks and had agents read each slice. each one pulled patterns like how i define done, what kind of code i reject, when i ask for proof, what makes me stop a task, and how i talk when i am actually working.\n\nthen i merged the repeated traits into one you.md.\n\nthe useful part is that it installs as a claude skill. so now instead of starting every task cold, claude reads my profile first and already knows how i work.\n\nnot memory exactly. memory is what you told the model. this is more like mining what your work already proved about you.\n\n \n

🡒 agent

🡒 agent + emulo

\n\nHere's how I'd play it.\n\n**Subreddits:** r/ClaudeAI and r/ChatGPTCoding are your core audience. r/LocalLLaMA fits the local angle. r/cursor, r/SideProject, r/opensource for reach. Don't blast all at once — post to one, tune the title, repost over a few days.\n\n**Title:** I built a local tool that reads your AI coding logs and writes a \"you.md\" your agents read before every task\n\n

full reply

\n\n**Titles (pick per sub):**\n- I built a local tool that reads your AI coding logs and writes a \"you.md\" your agents read before every task\n- emulo: mine your own Claude Code history into a profile so your agent codes like you (local, open source)\n\n**Body:**\n> Every fresh agent session starts from zero — it doesn't know how you work, so you re-explain yourself every time. All of that is already in your session logs. So I built **emulo**: it reads your history, mines how you decide and talk, and writes a `you.md` your agents read before every task.\n> - runs locally, your logs never leave your machine\n> - redacts secrets before processing\n> - open source: [link]\n\nAlso: open with the pain not the product, reply fast in the first hour, add a demo gif, and flair it correctly. Want me to write tuned variants for each subreddit?\n\n

\n\nthe insight first: the mining number is your whole post. \"i read 1,656 of my own sessions\" is a confession, not a pitch, and nobody scrolls past a confession. lead with the mirror, not the mechanism.\n\none sub, not five — a skills sub, where people come looking for this instead of arguing about it.\n\n**Title:** I built a Claude skill from 8 months of my own Claude Code sessions\n\n

the full post it wrote

\n\n**body:** I use claude code and codex every day. 8 months, solo. every session gets logged and i never really looked back at them.\n\nthen it hit me that those logs are probably the most honest record of how i actually work. not my CLAUDE.md, not my docs, not the rules i remembered to write down. the real sessions.\n\nso i built emulo.\n\nWhat I did: pulled every message i typed from my local claude/codex logs. stripped tool output, pasted errors, file dumps, and assistant replies. kept only my words. came out to around 1,656 sessions and almost 3M tokens of just me.\n\nthen i split it into chunks and had agents read each slice. each one pulled patterns like how i define done, what kind of code i reject, when i ask for proof, what makes me stop a task, and how i talk when i am actually working.\n\nthen i merged the repeated traits into one you.md.\n\nthe useful part is that it installs as a claude skill. so now instead of starting every task cold, claude reads my profile first and already knows how i work.\n\nnot memory exactly. memory is what you told the model. this is more like mining what your work already proved about you.\n\n

\n\nI posted it on r/ClaudeSkills, as written:\n\n

$\"The$

\n\n

200 upvotes · 32 comments · 102K views
\n_{from an account with no followers. The cold plan was reasonable. The loaded plan knew its user's voice — and it worked.}

\n\n## What it finds\n\nThe kind of rules a mine pulls out, each backed by dated verbatim receipts from real sessions:\n\n> **done means it runs live.** never trust \"done\" off a code edit. show it working first.\n>\n> **fix the one thing.** rewriting or \"cleaning up\" code that isn't the problem gets rejected every time.\n>\n> **builds faster than they understand what they built** — then asks the agent to explain their own system back.\n>\n> **gets frustrated by repeating the same ask** until it lands, not by escalating.\n\nNobody wrote those rules down. They came out of one person's own history, with receipts.\n\n> This is an example. Yours is mined from your logs and will read nothing like it.\n\n## The usage report\n\nMining answers \"who is this person.\" The usage report answers a different question: where are you losing time with the model.\n\n```bash\npython emulo.py --coach # every source it can find\npython emulo.py --coach --source claude # Claude Code only\n```\n\nIt runs before any mining, makes no model call, and finishes in seconds. It counts what your own messages already show: asks you sent three times in a row without changing them, context you re-explained after the agent lost it, runs where you rephrased the same request instead of adding the missing constraint, and how often you open a turn by correcting the last answer.\n\nEvery finding prints the dated messages behind it. Checks that come in under their bar are printed with their counts as well, so a clean result reads as a result rather than as silence.\n\nIt reads only the messages you typed, which is all Emulo keeps. It cannot see cost, tokens, tool calls, or whether the agent was right, and it never scores those.\n\n## The card\n\nAfter mining, `python emulo.py --card` renders your profile as a shareable card: archetype, top laws ranked by distinct supporting session receipts, coverage stats, and one sharp truth.\n\n

$\"An$

\n\nShare the card or one short trait, never your full profile.\n\n## Quickstart\n\nInstall the cross-agent bootstrap — runs in Claude Code and Codex, and installs profiles for Cursor and Gemini through the explicit adapters:\n\n```bash\nnpx skills add ohad6k/emulo@emulo\n```\n\nThen tell your agent:\n\n```text\nrun emulo\n```\n\nThat installs the bootstrap and creates a read-only full-history mining plan. Your agent must show the cost and wait for approval before model work.\n\nOnce your profile exists, the bootstrap offers the native plugin so you also get namespaced `emulo:` routing. It asks first and takes a no. In Codex it can run the install itself; in Claude Code `/plugin` is typed by you, so it hands you the two exact lines to paste.\n\n### Install the CLI\n\nIf you'd rather run Emulo yourself instead of through an agent:\n\n```bash\npip install emulo\n```\n\nThat puts `emulo` on your path. `emulo` runs the miner, `emulo --dry-run` prints the read-only plan first, and `emulo mcp` runs the MCP server below. `uv tool install emulo` works the same way, and `uvx emulo` runs it without installing.\n\n`emulo` writes `RUN_ME.md` next to your chunks. It is self-contained, so the whole remaining step is one line to your agent:\n\n```text\nread emulo-out/RUN_ME.md and follow it\n```\n\nYour agent makes one pass per chunk, merges them, writes `you.md`, and prints the install command. Nothing to paste and nothing else to download.\n\n### Check the receipts\n\nA profile is only worth loading if its evidence is real. The failure that matters is not a missing rule, it is a confident rule quoting something you never said:\n\n```bash\nemulo verify you.md\n```\n\nIt pulls every quote out of the profile and searches the mined sessions for it. Quotes it cannot find are reported and the command exits non-zero, because a receipt that cannot be traced was invented. Quotes resting on a single session are flagged separately: one session is context, not a rule. Add `--json` for machine-readable output, including which session ids support each quote.\n\nThis checks what is mechanically checkable. Whether a rule is vague, generic, or true of every developer alive is still a judgment call, and still yours.\n\n### Native Codex plugin\n\nThe native plugin adds `emulo:mine`, `emulo:work`, `emulo:design`, `emulo:write`, and `emulo:video`:\n\n```bash\ncodex plugin marketplace add ohad6k/emulo --ref v0.6.2 --json\ncodex plugin add emulo@emulo --json\n```\n\nThe plugin-install command itself scans no logs, writes no private profile state, and schedules zero mining model calls. Asking an agent to install, run, or update Emulo still consumes that host interaction plus its normal system and tool overhead.\n\n### Native Claude Code plugin\n\nThe Claude Code plugin exposes the same five skills. Install it from inside Claude Code:\n\n```text\n/plugin marketplace add ohad6k/emulo\n/plugin install emulo@emulo\n```\n\n## MCP server\n\nEmulo also ships a Model Context Protocol (MCP) server, so any MCP client — Claude Desktop, Cursor, and other agents — can load your profile before a task. The server implements MCP over stdio and exposes one tool, `load_emulo_profile`, which returns your mined work, design, or writing profile over the Model Context Protocol.\n\nRun it from the published package with `uvx emulo mcp`, or from a checkout with `python emulo.py mcp`, and point an MCP client at it:\n\n```json\n{\n \"mcpServers\": {\n \"emulo\": { \"command\": \"uvx\", \"args\": [\"emulo\", \"mcp\"] }\n }\n}\n```\n\nThe MCP server is stdlib-only and serves the profile you already mined locally; it makes no network calls of its own.\n\n## What happens when you run it\n\nEmulo first prints a read-only plan:\n\n```json\n{\n \"valid_sessions\": \"--\",\n \"post_dedupe_source_tokens\": \"--\",\n \"mode\": \"full\",\n \"profile_scope\": \"full_profile\",\n \"quality_default\": true,\n \"candidate_index\": null,\n \"selected_source_tokens\": \"--\",\n \"planned_worker_calls\": \"--\",\n \"planned_reducer_calls\": \"--\"\n}\n```\n\nThe full-history quality default reads all eligible history. Emulo shows the exact plan first and waits for approval before any worker or reducer runs. Cached reports are reused, so the displayed remaining cost can fall over time.\n\nIf you explicitly want a cheaper first look, ask for `run emulo quick preview` or use `--preview`:\n\n```bash\npython emulo.py plugin preflight --preview\n```\n\nQuick preview creates a starter profile from selected history, not the full profile.\n\nThe quick-preview ladder is:\n\n| Candidate | New source text | Maximum planned passes |\n|---|---:|---:|\n| 4 × 25K | 100K tokens | 4 workers + 1 reducer |\n| 6 × 25K | up to 150K tokens | up to 6 workers + 1 reducer |\n| 8 × 25K | 160K-token hard cap | up to 8 workers + 1 reducer |\n\nThe frozen calibration recovered only 5 of 22 required traits at the widest bounded candidate. Quick preview therefore cannot be described as the quality default unless a future run passes all 22 frozen requirements. The permanent non-private baseline is in `tests/fixtures/bounded-calibration-baseline.json`.\n\nThe first real full-history release mine recovered 12 of the same 22 frozen requirements: work `5/10`, design `5/5`, and writing `2/7`. Full history remains the quality default because it materially improves recall over preview, not because it guarantees a complete personal model. The validated pack keeps only supported rules; missing traits require future mining improvements rather than a softened score.\n\nOn update, unchanged segment and evidence hashes are reused. An identical update plans zero additional Emulo mining passes. New history plans only affected full-history work plus one reducer.\n\nThese are selected source tokens and planned worker/reducer passes, not provider billing events. Emulo cannot measure provider system prompts, tool traffic, orchestration overhead, or a percentage of a proprietary subscription allowance.\n\n### Experimental adaptive recall\n\nThe receipt-salience and scout pipeline remains available to developers through explicit `--stage A`, but it is experimental and is not used by the Plugin release, quality-default setup, updates, or calibration.\n\n## What makes the result trustworthy\n\n- Only real user-authored `.jsonl` messages are mined. `AGENTS.md`, `CLAUDE.md`, memory files, and typed self-descriptions are rejected as source evidence.\n- Every bounded worker covers work, design, writing, and video in one validated report.\n- Quotes must be short, dated, verbatim receipts from known session IDs.\n- Inferred rules require at least two distinct sessions and, when available, two source/time strata.\n- One uncontradicted explicit instruction may survive as low-frequency evidence.\n- Generic filler, invented quotes, unresolved contradictions, partial profile packs, and corrupt caches fail closed.\n\nThe native loaders are deliberately separate:\n\n| Skill | Loads |\n|---|---|\n| `emulo:work` | Core working profile |\n| `emulo:design` | Core + design taste |\n| `emulo:write` | Core + writing voice |\n| `emulo:video` | Core + video taste |\n| `emulo:mine` | Only explicit setup, update, or deepen requests |\n\n## Privacy\n\nEmulo's extractor, redaction, caches, and generated profiles stay local. Selected redacted text is processed by the model provider you choose. With a local model, the entire mining flow can remain local.\n\n`emulo.py` itself is one stdlib-only file and makes no network calls. The skills.sh command downloads the selected bootstrap. Outside a repository checkout, that bootstrap downloads only `emulo.py` and `MINING_PROMPT.md` from the exact release tag after SHA-256 verification. Those downloads happen before log discovery and read no session data.\n\nRedaction is best-effort and runs before selected text is written to Emulo caches. Inspect private output before sharing it. Share the card or one short trait, never your full profile or receipt appendix.\n\nSee [SECURITY.md](https://github.com/ohad6k/emulo/blob/main/SECURITY.md) for the exact boundary.\n\n## Raw one-file CLI\n\nThe legacy extractor remains available and backward compatible:\n\n```bash\ncurl -O https://raw.githubusercontent.com/ohad6k/emulo/v0.6.2/emulo.py\npython emulo.py --dry-run\npython emulo.py --chunks 4 --out emulo-out\n```\n\nManual adapters remain available:\n\n```bash\npython emulo.py --install you.md --target codex\npython emulo.py --install you.md --target claude\npython emulo.py --install you.md --target cursor --repo .\npython emulo.py --install you.md --target agents --repo .\npython emulo.py --install you.md --target gemini --repo .\npython emulo.py --install you.md --target opencode\n```\n\n## Support matrix\n\n| Surface | Status in this release |\n|---|---|\n| Codex native plugin | Proven locally with four namespaced skills |\n| Codex skills.sh bootstrap | Supported |\n| Claude Code skills.sh/direct adapter | Supported |\n| Claude native plugin | Not claimed; host unavailable during validation |\n| Cursor / Gemini adapters | Supported through explicit install commands |\n| OpenCode | Both directions verified live: sessions mined from its SQLite store and legacy JSON layout (`--source opencode`), profile installed to its global rules (`--target opencode`) |\n| Google Antigravity | Mining verified live against a real local install (`--source antigravity`): typed prompts extracted from `~/.gemini/antigravity/brain` transcripts, harness envelopes stripped. Antigravity only writes transcripts when interaction logging is enabled in its privacy settings |\n| OpenClaw / Hermes Agent | Profile skill discovery verified locally; [guide](https://github.com/ohad6k/emulo/blob/main/docs/OPENCLAW_HERMES.md) |\n\n## Updating and notifications\n\nRun `update emulo` to reuse stable caches and plan only changed work.\n\nA GitHub star bookmarks the repository but does not subscribe you to releases. To receive release notifications, choose **Watch → Custom → Releases** on GitHub.\n\n## Limits\n\n- Emulo models how you work, design, write, and make videos. It does not make the underlying model smarter.\n- Sparse or repetitive histories can leave design or writing inactive. Emulo reports the exact targeted-deepen instruction instead of inventing a persona.\n- Provider token accounting remains outside Emulo's exact measurement.\n- Benchmarks, leaderboard results, and proof videos are a separate later release.\n\n## FAQ\n\nThe three things people push back on, answered once.\n\n**\"Why not just ask Claude to summarize my logs?\"**\n\nOne pass can't do it. My history is 1,656 sessions, about 3M tokens after extraction, and the raw logs are mostly tool output, file dumps, and pasted errors. A single summarize call burns the window on that noise. Emulo keeps only the words you typed, gives each validated segment its own evidence pass, and requires distinct supporting sessions before an inferred rule can survive. The resulting profile keeps session receipts instead of an obsolete worker-count score.\n\n**\"Claude already has memory. Why do I need this?\"**\n\nUse both. Memory is what you told the model: curated notes, `CLAUDE.md`, and it stays inside one tool. Emulo reads supported raw sessions from Codex, Claude Code, Copilot CLI, OpenCode, and Google Antigravity and pulls out what you never wrote down: what you reject, what \"done\" means to you, and when you demand proof. The output is plain files you own and can load through supported agents.\n\n**\"Claude only keeps 30 days of logs. Where did 9 months come from?\"**\n\nClaude Code's retention is a setting (`cleanupPeriodDays`, 30 by default), and my longer history combines Claude Code, Codex, and Copilot CLI sessions plus archives. If you keep the default retention, older Claude sessions can roll off before Emulo sees them. Raise the retention, then mine what's left.\n\n## Roadmap\n\nSee [ROADMAP.md](https://github.com/ohad6k/emulo/blob/main/ROADMAP.md) for what is intentionally deferred.\n\n## Community\n\n- [Share what Emulo found](https://github.com/ohad6k/emulo/issues/1)\n- [Discord](https://discord.gg/QMnYtVcxk2)\n\n## License\n\nMIT. Made by [@ohad6k](https://github.com/ohad6k).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_108":109,"_110":111,"_112":113,"_114":115,"_116":117,"_118":119},"requiredSecrets",[],"tags",[93,94,95,96,97,98,99,100,101,102,103,104,105,106,107],"assets",[],"stats",{"_91":80,"_92":80},"ratingAvg","reviewCount","agent-memory","agent-skills","ai","ai-agents","ai-coding","ai-memory","claude","claude-code","codex","context-engineering","cursor","developer-tools","llm","local-first","memory","topics",[93,94,95,96,97,98,99,100,101,102,103,104,105,106,124,125,107,126,127,128],"license","MIT","language","Python","registryName","io.github.ohad6k/emulo","homepage","https://emulo.vercel.app","packages",[120],{"_121":122,"_123":21,"_70":71},"registryType","pypi","identifier","mcp","mcp-server","model-context-protocol","opencode","personalization","ENV",{"_131":132,"_133":134,"_135":136},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]