diff --git a/README.md b/README.md
index 4c217745..823376da 100644
--- a/README.md
+++ b/README.md
@@ -130,6 +130,23 @@ python frontends/qtapp.py                # Qt-based desktop app
 streamlit run frontends/stapp2.py        # Alternative Streamlit UI
 ```
 
+### Codeg 
+
+<table><tr>
+<td width="70%">
+
+[Codeg](https://github.com/yiqi-017/codeg) (`feat/genericagent-integration` branch) is a desktop/web UI that connects GenericAgent alongside other agents (Claude Code, Gemini, Codex, etc.) in a unified interface with a polished, modern UI.
+
+> This integration is usable now. Some features are still being refined — feedback welcome.
+
+Place your GenericAgent directory alongside the codeg project. Codeg will auto-detect `frontends/genericagent_acp_bridge.py` and launch GenericAgent as a local ACP agent.
+
+</td>
+<td width="30%">
+<img src="assets/demo/codeg-demo.gif" width="90%" alt="Codeg Demo">
+</td>
+</tr></table>
+
 ### Common Chat Commands
 
 The default Streamlit desktop UI started by `python launch.pyw`, plus the QQ / Telegram / Feishu / WeCom / DingTalk frontends, support these chat commands:
@@ -419,6 +436,23 @@ python frontends/qtapp.py                # 基于 Qt 的桌面应用
 streamlit run frontends/stapp2.py        # 另一种 Streamlit 风格 UI
 ```
 
+### Codeg前端
+
+<table><tr>
+<td width="70%">
+
+[Codeg](https://github.com/yiqi-017/codeg)（`feat/genericagent-integration` 分支）是一个桌面/Web UI，可以将 GenericAgent 与其他代理（Claude Code、Gemini、Codex 等）在统一界面中并行使用，UI 更加精美。
+
+> 此集成已可使用，部分功能仍在完善中，欢迎体验反馈。
+
+将 GenericAgent 目录放在 codeg 项目同级目录下，Codeg 会自动检测 `frontends/genericagent_acp_bridge.py` 并将 GenericAgent 作为本地 ACP 代理启动。
+
+</td>
+<td width="30%">
+<img src="assets/demo/codeg-demo.gif" width="90%" alt="Codeg Demo">
+</td>
+</tr></table>
+
 ### 通用聊天命令
 
 默认通过 `python launch.pyw` 启动的 Streamlit 桌面 UI，以及 QQ / Telegram / 飞书 / 企业微信 / 钉钉前端，都支持以下命令：
diff --git a/assets/demo/codeg-demo.gif b/assets/demo/codeg-demo.gif
new file mode 100644
index 00000000..cd120eff
Binary files /dev/null and b/assets/demo/codeg-demo.gif differ