Skip to content

emrg: README restructure — core differentiator front, compress parity features#534

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
argszero merged 1 commit into from
Aug 7, 2026
Merged

emrg: README restructure — core differentiator front, compress parity features #534

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 33 additions & 36 deletions README.cn.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -28,17 +28,42 @@ EMRG 是一个关于*自主进化*的实验。它能帮你写代码——读文

## ✨ 为什么你会爱上它

**一句话定位**：EMRG 是唯一一个**会因你的反馈而自我改进**的编程智能体——吐槽哪里不好，下一个演化周期它就自己写代码修好并上线。聊天、工具、记忆是标配；自我进化闭环才是它独一无二的地方。

| 特性 | 说明 |
|---|---|
| 🖥️ **Electron GUI（主入口）** | 非开发者主入口——安装即用：首次启动引导配置 API Key、聊天/会话/工具状态/设置全图形化。v0.2.5 完全重设计：浅/深双主题跟随系统、工具过程友好化（折叠展开）、多模型管理（增删改/设默认/对话中切换）、空状态欢迎屏、回到底部按钮。v0.2.6 键盘可达性补全：模型切换器/右键菜单/对话列表 ↑↓ 导航、表单 Enter 提交。v0.2.7 macOS 签名+公证零 Gatekeeper 弹窗。**v0.2.8：TUI 全部 15 个 / 指令 GUI 均可使用**（`/rant` 进化对话框、`/memory` 记忆浏览器、`/skills` 技能列表、会话管理、模型切换）。**GUI 配好即 TUI 可用**（配置共享）。**最新 — WorkBuddy 启发**：三栏布局结果面板（工具输出/生成文件卡片化，⌘\\ 折叠，窄屏自动隐藏）、**Ask/Auto 工作模式**（Ask 只对话不执行工具 / Auto 完整工具执行）、**自进化可见化**（侧边栏成长卡、每日一次进化 toast、关于页最近改进列表） |
| 🧠 **读写改跑，样样精通** | 完整的工具调用能力——bash、文件读写、diff 编辑 |
| 🔄 **吐槽驱动进化** | 你的 `/rant` 直接驱动后台演化循环——吐槽 → 分析 → 写代码 → 提 PR → 自动变强。**演化工作区自愈**（v0.2.8）：打包安装版按需 clone 仓库 + 自动补齐 projects/tasks 配置 |
| 🔄 **吐槽驱动进化（核心）** | 你的 `/rant` 直接驱动后台演化循环——吐槽 → 分析 → 写代码 → 提 PR → 自动变强。打包安装版演化工作区自愈：按需 clone 仓库 + 自动补齐 projects/tasks 配置 |
| 🖥️ **Electron GUI（主入口）** | 安装即用：首次启动引导配置 API Key；全部 15 个 `/` 指令 GUI 可用（`/rant` 进化对话框、`/memory` 记忆浏览器…）；WorkBuddy 启发的结果面板、Ask/Auto 模式、自进化可见化（成长卡 + toast）。GUI 配好即 TUI 可用 |
| 🧠 **读写改跑，样样精通** | 完整的工具调用能力——bash、文件读写、diff 编辑、glob、grep |
| 📝 **永不忘事** | 项目记忆 + 会话记忆 + 每日日志——上下文持续保留，不怕断线 |
| 🖥️ **颜值在线的 TUI** | 斜杠命令自动补全、会话选择器、流式 Markdown 渲染、请求计时器、ESC 中断。`/rant` `/model` `/memory` 等进阶命令 |
| ⚡ **并行工具调用** | 独立的工具调用并发执行，速度飞快 |
| 🔌 **微内核守护进程** | `emrgd` 持久运行——随时重连，状态不丢 |
| 🎮 **Vim 友好** | `j`/`k` 导航、`Ctrl+W`/`Ctrl+K` 编辑、`Tab` 展开工具卡片 |
| 🌍 **100% 开源** | MIT 协议——没有围墙，没有厂商锁定。**面向国际化**（v0.2.8）：全部 prompt 与文档默认英文，提供中文版 |
| ⚡ **全功能 TUI + 守护进程** | 流式 Markdown、`/` 自动补全、会话选择器、ESC 中断、Vim 友好按键、并行工具调用——跑在持久化的 `emrgd` 守护进程上，随时重连 |
| 🌍 **100% 开源** | MIT 协议——没有围墙，没有厂商锁定。面向国际化：默认英文，提供中文版 |

---

## 🔄 吐槽驱动演化（核心特色）

EMRG 不只是一个工具——它是一个**会听吐槽、会自我改进**的编程伙伴。

**你的吐槽是演化的第一推动力**。每次 `/rant` 都会被演化循环读取、分析、转化为代码改进：

```
📢 你的吐槽 (/rant) ←── 最主要的输入
📥 GitHub Issues & PRs
📥 竞品动态 (Codex, Claude Code)
📥 跨项目学习
↓
🧬 演化循环（每 30 分钟）
（准备 → 回顾 → 发现 → 改进 → 提交 → 记录）
↓
✅ pytest + import 检查
✅ git commit + push → PR
✅ 演化日志
```

**真实案例**：有人 rant "TUI 需要像 Codex 那样的 `/` 自动补全"。下一个演化周期，EMRG 自己实现了——完整的前缀过滤和方向键导航。合并，部署，搞定。**你对它吐槽什么，它就改进什么。**

全自动无人值守运行：`gh` 未认证时自动从 git 凭据提取 token、PR 投票走 REST API、打包安装版工作区自愈（按需 clone + 自动补齐配置）。详见 [MANIFESTO.md](MANIFESTO.md) —— EMRG 的设计宪章。

---

Expand DownExpand Up@@ -203,34 +228,6 @@ vision = true

---

## 🔄 吐槽驱动演化（核心特色）

EMRG 不只是一个工具——它是一个**会听吐槽、会自我改进**的编程伙伴。

**你的吐槽是演化的第一推动力**。每次 `/rant` 都会被演化循环读取、分析、转化为代码改进：

```
📢 你的吐槽 (/rant) ←── 最主要的输入
📥 GitHub Issues & PRs
📥 竞品动态 (Codex, Claude Code)
📥 跨项目学习
↓
🧬 演化循环（每 30 分钟）
（准备 → 回顾 → 发现 → 改进 → 提交 → 记录）
↓
✅ pytest + import 检查
✅ git commit + push → PR
✅ 演化日志
```

**真实案例**：有人 rant "TUI 需要像 Codex 那样的 `/` 自动补全"。下一个演化周期，EMRG 自己实现了——完整的前缀过滤和方向键导航。合并，部署，搞定。**你对它吐槽什么，它就改进什么。**

**演化环境健壮性**：演化循环在非交互环境运行，无法执行交互式 `gh auth login`。若 `gh` 未认证，循环会自动从 git 凭据存储（osxkeychain / credential helper）提取 token 作为 `GH_TOKEN` 使用（不落盘、不打印明文）；PR 评论/LGTM 计数查询自动走 REST API（GraphQL 需额外 `read:org` scope）。宿主只需配好 git 凭据，演化即可全自动运行。打包安装版演化工作区**自愈**（v0.2.8）：按需 clone 仓库、对齐安装版本 tag、自动补齐 `projects.yml`/`tasks.yml`——无需手动配置。

> 💡 详见 [MANIFESTO.md](MANIFESTO.md) —— 这是 EMRG 的设计宪章，阐述了 AI 时代自主进化的核心理念。

---

## 🏗️ 架构

```
Expand Down
65 changes: 31 additions & 34 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -28,17 +28,40 @@ EMRG is an experiment in *autonomous self-improvement*. It's an AI agent that he

## ✨ 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. Chat, tools, and memory are what you'd expect; the self-improvement loop is what you won't find anywhere else.

| What | What it means |
|---|---|
| 🖥️ **Electron GUI (main entry)** | Non-developer entry point — install and go: first-run wizard configures API key, chat/sessions/tool status/settings all graphical. v0.2.5 full redesign: light/dark theme (follows system), friendly tool status rows, multi-model management, empty-state welcome, back-to-bottom button. v0.2.6 keyboard accessibility: ↑↓ nav, Enter submit in forms. v0.2.7 macOS code signing + notarization — zero Gatekeeper dialogs. **v0.2.8: all 15 TUI slash commands now work in the GUI** (`/rant` evolution dialog, `/memory` browser, `/skills` list, session management, model switcher). **GUI configured = TUI ready** (shared config). **Newest — WorkBuddy-inspired**: three-column layout with a **results panel** (tool outputs & generated files as collapsible cards, ⌘\\ to collapse, auto-hides on narrow screens), **Ask/Auto working modes** (Ask = chat-only, no tool execution; Auto = full tool execution), and **visible self-evolution** (sidebar growth card, one-per-day evolution toast, recent-improvements list in About) |
| 🧠 **Reads, writes, edits, runs** | Full tool-calling agent — bash, files, diffs |
| 🔄 **Gets better on its own** | Background evolution cycles review rants + GitHub + competitor tools, then auto-PR improvements. **Self-healing workspace** (v0.2.8): packaged installs clone the repo on demand and bootstrap projects/tasks automatically |
| 🔄 **Gets better on its own** | **The core feature.** Background evolution cycles turn your `/rant`s, GitHub issues, and competitor updates into real improvements — analyzed, coded, tested, PR'd, merged. Self-healing workspace: packaged installs clone the repo on demand and bootstrap projects/tasks automatically |
| 🖥️ **Electron GUI (main entry)** | Install & go: first-run wizard configures your API key; all 15 slash commands work in the GUI (`/rant` evolution dialog, `/memory` browser…); WorkBuddy-inspired **results panel**, **Ask/Auto** modes, **visible self-evolution** (growth card + toasts). GUI configured = TUI ready |
| 🧠 **Reads, writes, edits, runs** | Full tool-calling agent — bash, files, diffs, glob, grep |
| 📝 **Never forgets** | Project memory + session memory + daily logs — context that persists |
| 🖥️ **Beautiful TUI** | Slash-command autocomplete, session picker, streaming markdown, elapsed timer, ESC interrupt. Advanced commands: `/rant` `/model` `/memory` |
| ⚡ **Parallel tools** | Independent tool calls run concurrently for speed |
| 🔌 **Micro-kernel daemon** | `emrgd` runs persistently — reconnect anytime without losing state |
| 🎮 **Vim-friendly** | `j`/`k` navigation, `Ctrl+W`/`Ctrl+K` editing, `Tab` to expand tool cards |
| 🌍 **100% open source** | MIT license — no walled garden, no vendor lock-in. **Internationalized** (v0.2.8): all prompts and docs in English, Chinese version available |
| ⚡ **Full-featured TUI + daemon** | Streaming markdown, `/` autocomplete, session picker, ESC interrupt, vim-friendly keys, parallel tool calls — on a persistent `emrgd` daemon you can reconnect to anytime |
| 🌍 **100% open source** | MIT — no walled garden, no vendor lock-in. Internationalized: 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 are the primary driver of evolution.** Every `/rant` is read, analyzed, and turned into code improvements:

```
📢 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." Next evolution cycle, EMRG built it — complete with prefix filtering and arrow-key navigation. Merged. Deployed. Done. **What you rant about, it improves.**

Runs fully unattended: `gh` auth auto-recovers from your git credentials, PR votes use the REST API, and packaged-install workspaces self-heal (clone on demand, auto-bootstrap projects/tasks). See [MANIFESTO.md](MANIFESTO.md) — EMRG's design charter on autonomous evolution.

---

Expand DownExpand Up@@ -203,32 +226,6 @@ vision = true

---

## 🔄 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 are the primary driver of evolution.** Every `/rant` is read, analyzed, and turned into code improvements:

```
📢 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." Next evolution cycle, EMRG built it — complete with prefix filtering and arrow-key navigation. Merged. Deployed. Done. **What you rant about, it improves.**

**Robust evolution environment**: the evolution cycle runs in a non-interactive environment where interactive `gh auth login` is impossible. If `gh` is unauthenticated, the cycle automatically extracts a token from git credential storage (osxkeychain / credential helper) as `GH_TOKEN` (never persisted, never printed); PR comment/LGTM counting queries automatically use the REST API (GraphQL needs an extra `read:org` scope). The host only needs git credentials configured — evolution runs fully automatically. On packaged installs, the evolution workspace **self-heals** (v0.2.8): clones the repo on demand, aligns to the installed release tag, and bootstraps `projects.yml`/`tasks.yml` — no manual setup.

> 💡 See [MANIFESTO.md](MANIFESTO.md) — EMRG's design charter on autonomous evolution in the AI era.

---

## 🏗️ Architecture

```
Expand Down
Loading