🧱 EMRG

The AI coding agent that writes code — and rewrites itself.

🇬🇧 English | 🇨🇳 中文

---

What if your coding assistant got better every time you used it?

EMRG is an experiment in autonomous self-improvement: an AI agent that helps you code — reading files, running commands, making edits — and every /rant you send drives it to improve itself. Tell it what bothers you, and the next evolution cycle writes the fix and ships it. Fully open source, fully transparent.

"EMRG is an experiment in self-evolving AI agent architecture." — MANIFESTO

---

✨ Why you'll love it

The one-line pitch: EMRG is the only coding agent that improves itself from your feedback — rant about what bothers you, and the next evolution cycle writes the fix and ships it.

What	Why it's different
🔄 Gets better on its own	The core feature. Your /rants, GitHub issues, and competitor updates become real improvements — analyzed, coded, tested, PR'd, merged, unattended
🖥️ Electron GUI (main entry)	Install & go: first-run wizard, all slash commands, results panel, Ask/Auto modes, visible self-evolution. GUI configured = TUI ready
⚡ Full-featured TUI + daemon	Streaming markdown, / autocomplete, sessions, shortcuts — on a persistent emrgd daemon you can reconnect to anytime
🌍 100% open source	MIT — no walled garden, no vendor lock-in. English default, Chinese version available

---

🔄 Rant-Driven Evolution (the core feature)

EMRG isn't just a tool — it's a coding partner that listens to your complaints and improves itself:

 📢 Your rants (/rant) ←── primary input
 📥 GitHub Issues & PRs
 📥 Competitor tools (Codex, Claude Code)
 📥 Cross-project learning
         ↓
    🧬 Evolution Cycle (every 30 min)
    (Prepare → Review → Discover → Improve → Commit → Record)
         ↓
    ✅ pytest + import check
    ✅ git commit + push → PR
    ✅ Evolution log

Real example: Someone ranted "TUI needs / autocomplete like Codex." The next evolution cycle built it — prefix filtering and arrow-key navigation, merged and deployed. What you rant about, it improves.

---

🚀 Quick Start

📦 Download the installer (recommended)

Download from GitHub Releases and double-click — the installer bundles everything (Python 3.13 + git + gh + GUI), zero prerequisites, offline install:

Platform	Installer
macOS	EMRG-<ver>-macos-arm64.pkg / -x64.pkg (user-level, no admin password)
Windows	EMRG-<ver>-windows-x64.exe (no UAC, PATH auto-registered)
Linux	EMRG-<ver>-linux-x86_64.AppImage / -aarch64.AppImage

Windows SmartScreen notice: the installer isn't Authenticode-signed — if SmartScreen prompts, click Keep / More info → Run anyway. EMRG is fully open source and auditable.

First time: launch EMRG → the wizard sets your API key / model → start chatting. The TUI is ready too: run emrg in any terminal (config is shared).

Prefer building from source, or need advanced config / architecture / contributing docs? → DEVELOPMENT.md

---

🎮 Commands

All commands work in both the GUI (type / for autocomplete) and the TUI (/help lists everything).

Command	What it does
Just type	Ask EMRG anything — it reads files, runs commands, makes edits
/	Autocomplete menu — type to filter, ↑↓ to select
/resume [id]	Switch sessions — no args for interactive picker (↑↓/j/k)
/sessions	Browse all saved sessions (↑↓/j/k)
/clear	Clear current session — start fresh
/compact	Compress long conversations to save context
/memory	Browse project & session memories
/rename [title]	Give your session a memorable name
/model [name]	Switch LLM model — no args for interactive picker
/rant <feedback> [@<project>]	Complain, suggest, praise — evolution listens
/help	Show keyboard shortcuts and command help
/image	Insert clipboard image into the input field
/delete [id]	Delete a session — no args for interactive picker
/rewind	Rewind conversation to a history point
/trigger	Trigger an evolution task — interactive picker
/skills	List loaded skills; `/skills available
/version	Show EMRG version and instance info
Esc	Interrupt a running response mid-stream
Ctrl+C / exit	Quit

---

📊 vs. the competition

	Claude Code	Codex	EMRG
AI-powered coding	✅	✅	✅
Tool-calling (bash, read, write, edit, glob, grep)	✅	✅	✅
Session memory & context	✅	✅	✅
/ command autocomplete	✅	✅	✅
ESC interrupt	✅	✅	✅
Self-evolution	❌	❌	✅ autonomous
Background daemon	❌	❌	✅ persistent
Learns from rants	❌	❌	✅ /rant → PR
Open source	❌	❌	✅ MIT

EMRG doesn't just keep up — it catches up on its own.

---

❓ FAQ

Is this real — does it actually modify its own code?
Yes. The evolution cycle reads the evolution prompt, reviews rants + issues + competitor tools, makes source changes, runs tests, and submits a PR. If tests fail, it rolls back.

Can it break itself?
Every change is validated by pytest and an import check before commit. Failed changes are discarded; the worst case is a rollback.

How is this different from Claude Code or Codex?
They're products. EMRG is an experiment in closing the loop — the AI improves the AI. Fully open source, no vendor lock-in.

---

🧪 Development

Contributing, source installs, architecture, and the full FAQ → DEVELOPMENT.md.

Quick checks: uv run pytest tests/ -v (currently 687 items) · cd emrg/gui && npm test (183: 43 daemon_client + 19 conn-manager + 22 app-commands + 63 renderer smoke + 15 i18n + 7 integration + 3 commands + 4 build-config + 7 gui-state)

---

📜 License

MIT — see LICENSE for the full terms and MANIFESTO.md for the philosophy behind the code.

---

_{Built with ❤️ by argszero — and a continuously evolving AI.}