Emulo mines your AI coding agent session logs (Claude Code, Codex, Cursor, etc.) into a private personal profile that your agents read before every task, so they learn your unwritten rules for work, design, writing, and video.

Stars

206

7-day growth

No data

Forks

18

Open issues

11

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the cold-start problem for AI agents by extracting real behavioral patterns from actual session evidence rather than relying on manually written rules, and it works across multiple agent platforms with a strong privacy-first local architecture.

Who it is for

  • Developers who use AI coding agents daily and want consistent, personalized interactions
  • Solo developers with extensive agent session histories who want to mine their own work patterns
  • Teams using agent tools like Claude Code, Codex, Cursor, or Gemini seeking unified agent behavior
  • Power users interested in open-source, auditable, local-first tooling for agent customization

Use cases

  • Personalize an AI coding agent to adhere to your coding standards, definition of 'done', and debugging approach
  • Create a sharable profile card that summarizes your work style without exposing full session logs
  • Improve agent output quality by loading a mined profile before starting a new task
  • Verify that your agent's profile is grounded in real session quotes using the built-in `emulo verify` command

Strengths

  • Zero-dependency, single-file CLI (stdlib only) that makes no network calls by default
  • Mines evidence from real user-authored messages, not from rules files or memory, and requires multiple sessions for inferred rules
  • Supports multiple agent platforms natively (Claude Code, Codex, Cursor, Gemini, OpenCode, etc.) with explicit plugins and adapters
  • Built-in verification tool that checks every quote against original session logs to prevent hallucinated rules

Considerations

  • Emulo profiles model how you work but do not make the underlying model smarter; results depend on the agent's capabilities
  • Sparse or repetitive session histories may leave design or writing profiles incomplete, and the quick-preview mode has reduced recall
  • Provider token accounting is outside Emulo's measurement, and benchmarks/leaderboards are planned for a future release

README quick start

Emulo

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

Your 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.

Emulo 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.

The 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).

The Emulo Proof v1 methodology is an unexecuted methodology until a separately approved evidence release exists.

Open source and Emulo Pro

Emulo's local engine stays MIT licensed and useful without an account. Your session extraction, redaction, caches, profile, and agent adapters remain on your machine unless you explicitly choose a model provider for mining.

Emulo Pro is the optional hosted layer for client-encrypted approved-generation continuity across up to five devices, managed pairing and revocation, conflict-preserving history, and a bounded encrypted recovery/export window. Raw session evidence, decryption keys, and model-provider tokens do not enter the hosted service. Ending Pro access never disables local Emulo, its history, or rollback.

The hosted Worker source is public so its authentication, checkout, webhook, and entitlement rules can be audited. Production credentials and customer records are held by Cloudflare and Polar and are never stored in Git. Public source code is not public access to the hosted service or its data.

Not memory

Memory is what you explicitly told the model.

Emulo 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.

That's why it reads raw session logs, not your CLAUDE.md or rules file.

A real run

One line to the same agent, twice: "help me post emulo on reddit." Once cold,

Description

Mine your Claude Code and Codex logs into a local you.md agent profile.

Related repositories

Similar projects matched by category, topics, and programming language.

0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312
7-e1even
Featured
7-e1even GitHub avatar

learn-agent

A collection of notes on building coding agents, derived from the production development of the desktop agent Reina, with each mechanism simplified into a zero-dependency, single-file Node.js demo.

AI & Machine LearningLarge Language Models
218