codeg

spacering-netApache-2.0活跃维护

把 Claude Code、Codex、OpenCode 等多个 AI 编程助手的会话聚合到一个工作区,支持桌面端、自托管服务器或 Docker 部署,方便统一管理和协作。

Collaborative multi-agent AI coding workspace: aggregate sessions from Claude Code, Codex, OpenCode, Pi, Grok Build, etc. Desktop app, self-hosted server, or Docker.

v0.42.1发布于 2026-11-06 23:38 UTC4,414star +29 / 7 天556fork同步于 2026-11-10 05:37 UTC

怎么上手

由 README 提炼,执行前请确认
从 https://github.com/spacering-net/codeg/releases/latest 下载安装包
硬件要求按 README 说明

README 未说明

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

把 Claude Code、Codex 等多个 AI 编码代理聚合到一个工作区,并让它们协作

把 Claude Code、Codex、OpenCode 等多个 AI 编程助手的会话聚合到一个工作区,支持桌面端、自托管服务器或 Docker 部署,方便统一管理和协作。

核心能力

  • 内置二十个代理,任何 ACP 代理都能接入,统一渲染为结构化对话
  • 导入、搜索并恢复各代理保存在磁盘上的历史会话,可转交给其他代理
  • 用 @ 提及代理进行委派,多个代理并行运行并实时流式输出进度
  • 在隔离的 worktree 中排队执行无人值守的待办任务,由你审核改动
  • 提供无限画布,可摆放对话、文件、终端和笔记

容易踩的坑

需先自行安装并配置好要接入的 AI 编码代理(如 Claude Code、Codex);桌面端、自托管服务器、Docker 和移动端部署方式不同,需按文档选择;通过 Telegram、Lark、微信接入需额外配置对应渠道

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.42.1
  1. v0.42.1codeg v0.42.1最新正式版2026-11-06 · 2026-11-06 23:38 UTC

    Release version 0.42.1

    This release lets you handle related issues in one task, keeps background work running when you leave a conversation, improves Office previews, and updates multiple agents.

    New

    • Related issues can be selected across pages and handled in one task, with a single PR or merge request and a choice of which issues it closes when merged.

    Improved

    • Claude Code is updated to 2.1.318 with adapter 0.101.0, and new sessions default to Auto unless you have selected another permission mode.
    • Claude Code’s idle context compaction appears directly in the conversation, including its summary, without needing to reopen the session.
    • Updated Hermes Agent to 0.23.0, CodeBuddy to 2.181.0, Grok to 1.0.77, Kimi Code to 2.5.2, Cursor to 2026.11.05-86047df, Qoder to 1.1.84, the ZCode bridge to 0.82.1 and Command Code to 1.88.4.

    Fixed

    • Closing or switching conversation panes, or refreshing the web page, no longer unexpectedly stops background commands, Remote Control or running sub-agents.
    • Office auto-preview reliably opens documents created or modified in the current turn, fixing unrelated templates opening, closed previews reappearing and occasional missed previews on Linux and Windows.
    • Updating Grok through codeg now runs the updated version, and uninstalling it correctly removes its installed status.
    • Kimi Code retains MCP execution environment and deferred tool-loading settings when codeg saves or syncs its configuration.
    • Kimi Code tool cards restore their correct titles when calls finish, instead of continuing to show reconnection or sign-in messages.
    • Qoder 1.1.84 keeps MCP tool cards and history displaying correctly, while codeg’s built-in tools such as questions continue without unnecessary permission requests.
    • Cursor conversation history includes the new access-management and code-execution tool steps.
    • The built-in browser no longer covers fullscreen tables or Mermaid diagrams opened from chat.
    • Agent error messages retain the file paths needed to locate and fix configuration problems.

    Note

    • Claude Code’s Auto mode may refuse commands when an API gateway cannot support its permission checks, in which case you can switch to Manual.
    • In Hermes 0.23.0, MCP servers configured in Hermes itself cannot connect when used alongside MCP servers injected by codeg.
    • On Linux, Windows and some macOS setups, disconnecting the session that started Hermes’ shared background service may interrupt tasks running in other Hermes conversations.

    Thanks to @Time-w (#1090), @HOMEFTW (#1091) and @monkeyDragonLiu (#1096) for the reports.


    发布版本 0.42.1

    这一版支持将多个相关 Issue 合并为一个任务处理,修复会话页面关闭导致后台任务中断、Office 文档误弹出等问题,并更新多个智能体。

    新增

    • 支持跨页多选相关 Issue 并合并为一个任务处理,统一交付为 PR 或合并请求,并选择合并后关闭哪些 Issue。

    改进

    • Claude Code 更新至 2.1.318,适配器更新至 0.101.0,未指定其他权限模式时,新会话默认使用 Auto 模式。
    • Claude Code 空闲时自动压缩上下文的结果会直接显示在会话中,无需重新打开即可查看压缩摘要。
    • Hermes Agent 更新至 0.23.0,CodeBuddy 更新至 2.181.0,Grok 更新至 1.0.77,Kimi Code 更新至 2.5.2,Cursor 更新至 2026.11.05-86047df,Qoder 更新至 1.1.84,ZCode 桥接更新至 0.82.1,Command Code 更新至 1.88.4。

    修复

    • 关闭或切换会话面板、刷新网页时,后台命令、远程控制和正在运行的子智能体不再被意外中断。
    • Office 自动预览准确识别智能体本轮创建或修改的文档,修复无关模板误打开、关闭后反复弹出及 Linux、Windows 下偶尔漏开预览的问题。
    • 通过 codeg 更新 Grok 后会实际运行新版本,卸载后也会正确显示为未安装。
    • 保存或同步 Kimi Code 的 MCP 配置时,会保留运行环境和工具延迟加载设置。
    • Kimi Code 工具调用结束后会恢复正确的卡片标题,不再残留「重连中」或登录授权提示。
    • Qoder 升级至 1.1.84 后,MCP 工具卡片和历史记录仍能正确显示,codeg 内置提问等工具也不会出现多余的授权请求。
    • Cursor 历史会话能正确显示新增的权限管理和代码执行工具步骤。
    • 打开聊天中的全屏表格或 Mermaid 图表时,内置浏览器页面不再遮挡内容。
    • 智能体错误提示会保留相关文件路径,方便定位和修复配置问题。

    注意

    • Claude Code 的 Auto 模式在 API 网关无法支持其权限检查时可能拒绝执行命令,遇到这种情况可切换至 Manual 模式。
    • Hermes 0.23.0 自身配置的 MCP 服务,在与 codeg 注入的 MCP 服务同时使用时暂时无法连接。
    • 在 Linux、Windows 及部分 macOS 环境中,断开启动 Hermes 共享后台服务的会话,可能中断其他 Hermes 会话正在执行的任务。

    感谢 @Time-w(#1090)、@HOMEFTW(#1091)和 @monkeyDragonLiu(#1096)的问题反馈。

  2. v0.42.0codeg v0.42.02026-11-03 · 2026-11-03 23:31 UTC
    查看更新说明

    Release version 0.42.0

    This release adds CNB repository support and global system instruction editing, makes tasks awaiting your response easier to continue, and improves notifications and conversation history.

    New

    • CNB (cnb.cool) joins the supported code hosting platforms, with issue and merge request management, automatic issue processing, and task delivery through merge requests. (#1066, @abigmiu)
    • Global system instructions can be viewed and edited directly in agent settings for supported agents such as Claude Code, Codex and OpenCode, making it easier to set preferences and working rules. (#1060, @ana52070)
    • Channel and webhook notifications can be limited to top-level session completions and errors, reducing sub-agent notifications while keeping permission requests and questions visible.

    Improved

    • Tasks awaiting permission, an answer or plan approval now prioritize “Respond”, opening the conversation so you can handle the request and let the task continue.
    • Webhook notifications include conversation, agent and parent-session details, making their source and delegation relationships easier to identify.
    • Expandable steps in the execution timeline highlight on hover and keyboard focus, making it easier to see which step you are about to open.
    • Self-updated Hermes 0.22.6 installations retain provider-grouped model selection and mode switching, with reasoning effort available alongside them.
    • Updated Claude Code to claude-agent-acp 0.100.0 and CodeBuddy to 2.179.3.

    Fixed

    • OpenCode’s / menu once again lists the skills it loads, making them available in chat, automation and task editors.
    • OpenCode’s default model lists in Settings correctly hide disabled models and providers. (#1079, @xyalter)
    • DeepSeek Harness 0.2.x history correctly displays tool output, failures and cache-write usage, including conversations migrated from earlier versions. (#1086, @Cuinnchen)
    • PowerShell in the built-in terminal and “Run on this computer” loads your profile, allowing fnm, conda, aliases and other environment customizations to work.
    • Reopening a Pi conversation correctly restores its message history, fixing cases where the conversation appeared empty.
    • Claude Code preserves the original conversation and explains why it cannot be restored, avoiding an unexpected switch to an empty session when it is held by a background task or its worktree cannot be reopened.
    • Claude Code replies triggered by MCP prompt commands no longer appear twice in the conversation.

    Thanks to @abigmiu, @ana52070, @xyalter and @Cuinnchen for contributing to this release, and to @grykom, @branll, @DaYePython and @ZhangSanMo for the reports and suggestions.


    发布版本 0.42.0

    这一版新增 CNB 仓库支持和全局系统提示词编辑,让等待你回应的任务更容易继续,并改进消息通知与历史会话展示。

    新增

    • 新增腾讯 CNB(cnb.cool)支持,可管理 Issue 和合并请求、自动处理 Issue,并将任务成果交付为合并请求。(#1066,@abigmiu)
    • 支持在智能体设置中直接查看和编辑全局系统提示词,适用于 Claude Code、Codex、OpenCode 等智能体,方便配置角色、回复偏好和工作规范。(#1060,@ana52070)
    • 消息渠道和 Webhook 可仅推送主会话的完成与错误通知,减少子智能体的通知干扰,同时保留授权请求和提问提醒。

    改进

    • 等待授权、回答问题或审批计划的任务会优先显示「去回应」,点击即可打开会话处理请求,回应后任务会自动继续。
    • Webhook 通知会附带会话、智能体及父会话信息,方便识别消息来源和委派关系。
    • 执行过程中可展开的步骤会在鼠标悬停或键盘聚焦时高亮,更容易看清即将打开的步骤。
    • 兼容自行升级的 Hermes 0.22.6,保留按供应商分组的模型选择和模式切换,并支持调整推理强度。
    • Claude Code 适配器更新至 claude-agent-acp 0.100.0,CodeBuddy 更新至 2.179.3。

    修复

    • OpenCode 的 / 菜单恢复显示已加载的技能,可在聊天、自动化和任务编辑器中直接选用。
    • OpenCode 设置中的默认模型列表会正确隐藏已禁用的模型和供应商。(#1079,@xyalter)
    • DeepSeek Harness 0.2.x 的历史会话能正确显示工具输出、失败状态和缓存写入用量,从旧版迁移的会话也能正常查看。(#1086,@Cuinnchen)
    • 内置终端和「在本机运行」会正确加载 PowerShell 个人配置,让 fnm、conda、命令别名等自定义环境正常生效。
    • 重新打开 Pi 会话时可以正确恢复历史消息,修复部分会话记录显示为空的问题。
    • Claude Code 无法恢复会话时会保留原会话并说明原因,避免因后台任务占用或工作树无法重新打开而误切到空白会话。
    • Claude Code 使用 MCP 提示词命令时,同一轮对话不再重复显示。

    感谢 @abigmiu、@ana52070、@xyalter 和 @Cuinnchen 为本次发布做出的贡献,也感谢 @grykom、@branll、@DaYePython 和 @ZhangSanMo 的问题反馈和功能建议。

  3. v0.41.4codeg v0.41.42026-11-02 · 2026-11-02 18:52 UTC
    查看更新说明

    Release version 0.41.4

    This release renders inline math more reliably, fixes duplicated terminal output in remote workspaces, makes the execution timeline easier to read, and updates five agents.

    New

    • ZCode supports /rename to rename the current session, and the conversation title in codeg updates to match unless you have already renamed the conversation yourself.
    • OpenCode's reserved space before automatic compaction can be set as a share of the context window, such as 20%, as well as a token count.

    Improved

    • Resumed delegations appear as delegation rows in the execution timeline, marked as resumed and showing the reason for resuming.
    • Read and search steps inside explore groups use the same layout as command rows, and the secondary text of non-text steps has higher contrast.
    • Updated OpenCode to 2.2.5, CodeBuddy to 2.179.2, Kimi Code to 2.4.1, Antigravity to 1.4.5 and the ZCode bridge to 0.82.0.
    • Kimi Code can read text files up to 16 MiB, so files larger than 2 MiB no longer fail to load.

    Fixed

    • Single-dollar inline formulas such as $T$ now render as math, while amounts, shell variables and code stay exactly as written. (#1081, @xy3xy3)
    • Opening another window in a remote workspace no longer duplicates terminal output, including the window for importing local conversations. (#1085, @xyalter)
    • Background command and image generation cards in OpenCode history now show their final results and no longer stay stuck as running.

    Note

    • OpenCode's /goal, /init and /review commands currently show no progress after you send them, and the session can stop responding if a step needs your approval.
    • OpenCode's background command and image generation results appear after you reopen the conversation, not while they are still running.

    发布版本 0.41.4

    这一版改进了行内公式的渲染,修复了远程工作区终端输出重复的问题,让执行过程时间线更易阅读,并更新了五个智能体。

    新增

    • ZCode 支持用 /rename 重命名当前会话,codeg 中的会话标题会同步更新,你自己改过的标题不会被覆盖。
    • OpenCode 自动压缩前预留的空间可以按上下文窗口占比填写,例如 20%,也可以继续填写 token 数。

    改进

    • 恢复后的委派在执行过程时间线中显示为委派行,并带有已恢复标记和恢复原因。
    • 探索分组里的读取和搜索步骤改用与命令行一致的布局,非文字步骤的次要文字也更加清晰。
    • OpenCode 更新至 2.2.5,CodeBuddy 更新至 2.179.2,Kimi Code 更新至 2.4.1,Antigravity 更新至 1.4.5,ZCode 桥接更新至 0.82.0。
    • Kimi Code 支持读取最大 16 MiB 的文本文件,查看超过 2 MiB 的文件时不再失败。

    修复

    • $T$ 这类单美元符号行内公式现在可以正常渲染,金额、Shell 变量和代码内容仍按原样显示。(#1081, @xy3xy3)
    • 在远程工作区打开其他窗口时,终端输出不再重复显示,打开导入本地会话的窗口也是如此。(#1085, @xyalter)
    • OpenCode 历史会话中的后台命令和图片生成卡片会显示最终结果,不再一直停留在运行中。

    注意

    • OpenCode 的 /goal、/init、/review 命令发出后暂时看不到执行进度,如果中途需要授权,会话可能停止响应。
    • OpenCode 后台命令和图片生成的结果需要重新打开会话才会显示,运行期间暂时无法实时看到。
  4. v0.41.3codeg v0.41.32026-10-30 · 2026-10-30 01:57 UTC
    查看更新说明

    Release version 0.41.3

    This release improves file pasting and reply presentation, adds new Claude Code and Codex capabilities, and brings support for larger workspace backgrounds.

    New

    • Claude Code offers a thinking-summary switch, letting you show summaries of its reasoning from the agent’s settings.
    • Codex offers follow-up prompt suggestions in chat, while automated runs skip generating suggestions to avoid extra model requests.
    • GPT-6.1 Terra joins Codex’s built-in model list, with matching context-usage tracking.

    Improved

    • Pasting files and folders into desktop chat is more reliable, including files copied from your file manager and pasted through the right-click menu.
    • Claude Code skills are easier to identify in / menus, with skill icons in chat, automation and task editors, plus source paths on hover when available.
    • Instructions sent while Codex is working can guide the current task directly, while messages sent during an approval request stay queued.
    • Workspace backgrounds support images up to 64 MiB and 100 million pixels, with more time allowed for large transfers and wallpaper downloads.
    • Opening text flows naturally into later execution steps, with smoother transitions from waiting to the first reply content.
    • Updated Claude Code to claude-agent-acp 0.99.1 and Codex to codex-acp 2.5.0.
    • Antigravity 1.4.4 can read text files up to 16 MiB, avoiding failures when viewing files larger than 2 MiB.
    • ZCode 0.79.1 improves request retries and failure messages, allowing you to resend in the same conversation when retries are exhausted.

    Fixed

    • Claude Code receives pasted PDFs correctly and preserves their attachment display in history, without duplicating messages sent with only an attachment.
    • Claude Code can fork conversations across working directories and offers a sign-in action when your login expires.
    • Codex history preserves clickable file references and gives clearer explanations for ChatGPT workspace connection failures.
    • Codex handles Google Cloud Vertex AI configuration correctly, avoiding incompatible settings when binding a provider or changing WebSocket options.
    • Command Code 1.88.2 fixes a startup failure affecting fresh installations.
    • Qoder 1.1.81 stops pending tool calls correctly when you cancel during approval, and history retains the model name when later records leave it blank.

    Note

    • Qoder’s follow-up reply after a background sub-agent finishes currently appears after reopening the conversation, rather than arriving live.

    发布版本 0.41.3

    这一版改进了文件粘贴与回复展示,扩展 Claude Code 和 Codex 的使用体验,并支持更大、更高清的工作区背景图。

    新增

    • Claude Code 新增「显示 Claude 的思考摘要」开关,可在智能体设置中开启,查看推理过程的摘要说明。
    • Codex 支持在聊天输入框显示后续问题建议,自动化等无人输入场景则跳过生成建议,减少额外模型请求。
    • Codex 内置模型列表新增 GPT-6.1 Terra,并适配对应的上下文用量显示。

    改进

    • 桌面端粘贴文件和文件夹更加可靠,从文件管理器复制后即可添加为智能体可访问的附件,右键「粘贴」同样适用。
    • Claude Code 技能在 / 菜单中更容易辨认,聊天、自动化和任务编辑器均显示技能图标,有来源路径时还可悬停查看。
    • Codex 运行中收到的补充要求可以直接引导当前任务,等待授权期间发送的消息则排队保留。
    • 工作区背景图上限提升至 64 MiB、1 亿像素,同时延长大图传输和壁纸下载的等待时间。
    • 回复开头的文字与后续执行步骤衔接更加自然,从等待状态切换到首段回复时也更平滑。
    • Claude Code 适配器更新至 claude-agent-acp 0.99.1,Codex 适配器更新至 codex-acp 2.5.0。
    • Antigravity 更新至 1.4.4,支持读取最大 16 MiB 的文本文件,避免查看超过 2 MiB 的文件时失败。
    • ZCode 适配器更新至 0.79.1,改进请求重试与失败提示,重试未成功时仍可在原会话中重新发送。

    修复

    • Claude Code 可以正确接收粘贴的 PDF,并在历史中保留附件展示,仅发送附件时也不会重复显示消息。
    • 修复 Claude Code 跨工作目录分叉会话失败的问题,并在登录过期时提供重新登录入口。
    • Codex 历史会话保留可点击的文件引用,并为 ChatGPT 工作区连接失败提供更清晰的说明。
    • 修正 Codex 对 Google Cloud Vertex AI 的配置处理,避免绑定供应商或切换 WebSocket 设置时写入不兼容的配置。
    • Command Code 更新至 1.88.2,修复全新安装后可能无法启动的问题。
    • Qoder 更新至 1.1.81,等待授权时点击停止会正确结束对应工具调用,历史记录中的空模型字段也不会再覆盖原有模型名称。

    注意

    • Qoder 后台子智能体完成后的后续回复,目前需要重新打开会话才能查看,暂时无法实时显示。
  5. v0.41.2codeg v0.41.22026-10-29 · 2026-10-29 02:22 UTC
    查看更新说明

    Release version 0.41.2

    This release makes replies smoother to follow, keeps background tasks compact, and improves reliability for Kimi Code and CodeBuddy.

    Improved

    • Replies flow more smoothly as they arrive, with gradual text appearance and natural transitions between messages, steps, command output and completed results, respecting chat animation and reduced-motion settings.
    • Background tasks can collapse to a single line with a task count, while longer lists scroll within a limited height to leave more room for the conversation.
    • The activity header follows your chat theme and workspace background, with clearer hover feedback and readable text.
    • Updated CodeBuddy to 2.177.1, Kimi Code to 2.4.0, Command Code to 1.88.1 and the ZCode bridge to 0.78.0.
    • ZCode supports GLM Coding Plan API keys, using keys saved in the desktop app or configured separately through terminal setup.
    • Command Code handles image-heavy conversations more reliably, automatically reducing image payloads or compacting context before retrying oversized requests.

    Fixed

    • Streaming replies keep consistent paragraph, list and code-block layouts, reducing flicker and sudden shifts as content arrives or the reply finishes.
    • Command groups stop appearing as the current step once the reply moves on, while commands running in the background retain their actual status.
    • Quickly expanding and collapsing the activity header works reliably, without accidentally selecting its text or opening the copy popup.
    • Kimi Code’s plan mode no longer ends unexpectedly at the first tool call, allowing the agent to continue gathering information and preparing its plan.
    • Stopping CodeBuddy no longer loses the next queued message or incorrectly marks a completed follow-up reply as cancelled.

    发布版本 0.41.2

    这一版让回复生成和执行过程的展示更加流畅,减少后台任务对聊天空间的占用,并修复 Kimi Code 和 CodeBuddy 的会话问题。

    改进

    • 回复生成过程更加顺畅,文字逐步呈现,消息、执行步骤、命令输出和最终结果自然衔接,并遵循聊天动画与系统减少动态效果设置。
    • 后台任务支持收起为显示任务数量的一行,任务较多时可在固定高度内滚动查看,为对话留出更多空间。
    • 「执行过程」标题更好地融入聊天主题和工作区背景图,鼠标悬停时的反馈和文字也更清晰。
    • 同步更新 CodeBuddy 至 2.177.1、Kimi Code 至 2.4.0、Command Code 至 1.88.1,以及 ZCode 适配器至 0.78.0。
    • ZCode 支持使用 GLM Coding Plan API 密钥连接,可沿用桌面端保存的密钥,也可在终端单独配置。
    • Command Code 处理多图会话更加可靠,请求过大时会自动缩减图片内容或压缩上下文后重试。

    修复

    • 流式回复中的段落、列表和代码块保持一致的排版,减少生成过程中及回复完成时的闪烁和位置跳动。
    • 回复进入后续步骤后,旧命令组不会再误显示为当前执行步骤,后台命令仍会保留实际运行状态。
    • 快速展开和收起「执行过程」时能正确响应点击,不会再意外选中文字并弹出复制提示。
    • 修复 Kimi Code 计划模式在首次调用工具时意外结束的问题,智能体可以正常继续收集信息并制定计划。
    • 修复 CodeBuddy 停止后丢失下一条排队消息,以及后续已完成回复被误标为取消的问题。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    💖 Sponsors

    Want to become a Codeg sponsor? Reach out to us by email.

    ✨ Features

    One Interface for Every Agent

    Twenty agents, plus any ACP agent, in one rich chat with tool cards, live diffs, and interactive replies.

    Docs → · Custom agents → · UI Render →

    Every Session, Searchable

    Import, search, and resume any agent's history. Share sessions with @ mentions and organize them with tags.

    Docs → · Tags →

    Multi-Agent Collaboration

    @ an agent to delegate. Run agents side by side and watch their progress stream into your conversation.

    Docs →

    To-dos That Run Unattended

    Schedule tasks in isolated worktrees. Agents handle the work; you review and approve the changes.

    Docs → · Auto-processing →

    Infinite Canvas

    Arrange chats, files, terminals, and notes on an infinite board. Keep every agent's work in view.

    Docs →

    Desktop, Server, Mobile & Chat

    Work on desktop, server, Docker, or mobile. Reach your agents through Telegram, Lark, and WeChat.

    Docs → · Remote workspaces → · Mobile apps → · Chat channels →

    Office Documents & Research

    Create Office files with live previews and view PDFs beside chat. Research skills work with any agent.

    Docs → · Research →

    Browser & Computer Use

    Share pages and errors from the desktop browser. Let agents operate shared windows with Computer Use (preview).

    Docs → · Computer Use →

    Command Line & CI

    Run prompts from scripts or CI with codeg-cli. Connect to a running Codeg for replies or JSON events.

    Docs →

    codeg-cli -a codex \
      -p "Review the latest commit"
    
    git diff | codeg-cli -a codex \
      -p "Review this diff"
    

    Also in the box:

    • The Full Engineering Loop — a code editor, live diffs, Git & worktrees, a three-pane merge editor, terminals, and split views
    • Repository Panel — issues, pull requests, checks, and merges for GitHub, GitLab, Gitea, and Forgejo; any issue or PR can become a to-do
    • Automations — save a configured composer and run it headlessly, on a cron schedule or on demand
    • Token Usage — trends, cache hit rate, an activity heatmap, usage by folder, agent, model, and session, and what it would cost at API list prices
    • Fork & Steer — fork a conversation from a finished reply, or send a message into a turn that is still running, on agents that support it
    • Skills & MCP — skill packs per agent, a local MCP scan, and registry search and install
    • Project Boot — scaffold a new project visually, with a live preview
    • Notifications — desktop notifications, sounds, and a flashing taskbar button or bouncing Dock icon when a turn ends or an agent needs you
    • Make It Yours — twelve themes you can recolor token by token, wallpapers, corner radius, chat width, custom CSS, and a desktop pet — in any of ten interface languages
    • Backup & Sync — encrypted backups, and configuration sync between machines through a file or your own WebDAV server
    • URL Scheme — codeg://session/<id> opens a conversation from another app (desktop)
    • And more — nearly every release adds something; the release notes are the full list

    🤖 Supported Agents

    Codeg talks to every agent over the Agent Client Protocol, so each one gets the same structured interface. Twenty come built in, and Codeg installs, pins, and updates most of them for you:

    Not on the list? Pick any agent from the public ACP registry or paste its distribution JSON — Codeg installs it, checks that it launches, and treats it like a built-in. Runtime requirements and where each agent keeps its sessions: Supported Agents.

    📦 Install

    Desktop — installers for macOS, Windows, and Linux are on Releases; setup steps in Installation.

    Server — run Codeg headless and reach it from any browser. On Linux or macOS:

    curl -fsSL https://raw.githubusercontent.com/spacering-net/codeg/main/install.sh | bash
    CODEG_STATIC_DIR=/usr/local/share/codeg/web codeg-server
    

    On Windows, in PowerShell:

    irm https://raw.githubusercontent.com/spacering-net/codeg/main/install.ps1 | iex
    $env:CODEG_STATIC_DIR="$env:LOCALAPPDATA\codeg-server\web"; codeg-server
    

    Docker — the same server, in one container:

    docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/spacering-net/codeg:latest
    

    Either way, open http://<host>:3080 in a browser and enter the access token the server prints when it starts (docker logs shows it for the container), or set CODEG_TOKEN to choose your own.

    Mobile — install the iOS app or the Android APK, then point it at the Web Service of your desktop app or at your own codeg-server: URL, token, done. Pairing steps in Mobile apps.

    Compose, prebuilt binaries, source builds, and in-place updates are covered in Deployment; environment variables in Configuration.

    👥 Community & Support

    • WeChat — scan the QR code to join our group for discussions, feedback, and updates:

    • Issues — found a bug or missing a feature? Open an issue.

    • Privacy — local-first: parsing, storage, and project operations stay on your machine, and web and server modes are guarded by token authentication. Details in Privacy & Security.

    • LinuxDO — thanks to the LinuxDO community for their support.

    • Show support — star the repo to follow along.

    🤝 Contributing

    Issues and pull requests are welcome. To build Codeg yourself, start with Development and Architecture.

    ⭐ Star History

    🙏 Acknowledgments

    📜 License

    Apache-2.0. See LICENSE.