CodeM 是一个面向本地编码 Agent 的桌面工作台。

它把本机 Claude Code、OpenAI Codex、Grok Build 与 OpenCode CLI 接入统一图形界面，让你可以管理项目、继续热会话、查看运行过程、处理权限确认，并把聊天记录和项目状态保存在本机。

CodeM 直接使用各 Agent 的原生 CLI、会话和配置目录，不接管账号凭据，也不会自动同步不同 Agent 的配置。

项目和会话集中在左侧，当前会话在中间展开，底部输入框保留权限、模型和运行状态。

对话、文件和项目上下文可以放在同一个窗口里，日常写代码时不用在终端和文件管理器之间来回切。

主题、强调色、窗口材质、界面密度和字体可以在设置里调整，尽量贴合自己的桌面环境。

内置使用情况视图，用来查看会话、Token、耗时和费用的简单统计。

• 调用本机 claude、codex、grok CLI，并实时展示 Agent 输出
• 按项目管理聊天，会话可以继续复用 sessionId
• 支持切换工作目录、停止运行、继续输入和队列发送
• 支持默认、自动执行、完全访问三档权限模式
• 支持 Plan 确认、权限审批和 AI 提问卡片
• 支持 Markdown / GFM 渲染，工具调用会折叠展示
• 支持 TodoWrite 计划卡片和运行状态展示
• 支持项目级 Git 分支和变更数量展示
• 支持工作台视图，可以查看文件、审查、浏览器等区域
• 支持主题、强调色、窗口材质、界面密度和字体设置
• 项目、线程、消息和工具调用会持久化到本机 SQLite

最新稳定版可以从 GitHub Releases 下载。

• 当前桌面版统一使用内置 Rust 后端，安装包不依赖系统 Node.js。
• Windows 提供安装版和 portable 绿色版；macOS 提供 Apple Silicon 安装包；Linux 提供 AppImage、deb 和 rpm。

先确认本机至少安装了一个受支持的 Agent CLI。Claude Code、Codex、Grok Build 与 OpenCode 都可以在“Agent 设置”中检测、安装或更新：

claude --help
codex --version
grok --version
opencode --version

CodeM 不保存这些 CLI 的账号凭据。OpenCode 可通过 OPENCODE_CLI_PATH 指定可执行文件，Windows 会自动避开不能直接启动的 npm .cmd / .ps1 包装脚本。

安装依赖：

npm install

启动 Web 开发模式：

npm run dev

默认地址：

• 前端：http://127.0.0.1:5173
• 后端：默认 http://127.0.0.1:3001，如果端口不可用会自动切换
• 本地数据库：%LOCALAPPDATA%\CodeM\codem.sqlite

npm run desktop:dev

桌面开发模式使用 Tauri，并会尽量复用当前仓库正在运行的 Web 和后端服务：

• src/** 改动通过 Vite HMR 即时刷新
• Rust 后端由 src-tauri/** 提供，开发模式通过 cargo run --bin codem-backend 启动
• src-tauri/** 改动通过 Rust/Tauri 工具链重新编译；桌面壳会随 tauri dev 重启

1. 确保当前机器可以执行 claude --help
2. 启动 CodeM
3. 在左侧选择或添加项目目录
4. 在输入框输入需求并发送
5. 当前线程默认续聊，新建聊天不会删除旧线程

建议只在可信目录里使用“完全访问”权限模式。这个模式会让 Claude Code 跳过部分权限确认，适合自己的开发目录，不适合陌生代码仓库。

• 前端：React + Vite
• 桌面壳：Tauri
• 后端：Rust + Axum
• Agent 调用：本机 claude、codex、grok、opencode CLI
• 本地持久化：SQLite（Rust rusqlite）

打包前先检查本机基础环境：

npm run package:doctor

常用入口：

npm run package:win                 # Windows x64
npm run package:mac-arm64           # macOS Apple Silicon
npm run package:mac-x64             # macOS Intel
npm run package:mac-universal       # macOS Universal
npm run package:linux               # Linux x64
npm run package:all                 # 当前系统推荐目标

桌面后端由 Rust 随 Tauri 应用一同编译，不再区分 with-node / no-node 安装包，也不再打包 dist-server Node 后端资源。

应用内自动更新使用 GitHub Release 中的桌面安装产物。发布 workflow 会为安装产物生成 Tauri updater 签名和 latest.json；启用 release 自动更新前，需要在 GitHub Secrets 中配置 TAURI_SIGNING_PRIVATE_KEY，如果私钥设置了密码，还需要配置 TAURI_SIGNING_PRIVATE_KEY_PASSWORD。

• 各 Agent 的模型、权限和工具能力以 Provider Registry 与本机 CLI 实际返回为准
• OpenCode 通过 ACP 接入会话、流式事件、模型选择、审批、MCP 与 Skills；插件仍由 OpenCode 自行加载，CodeM 当前不管理其插件市场
• Claude CLI 参数如果未来变动，后端桥接需要同步调整
• Plan、审批、AI 提问会暂停等待用户决策
• 线程历史持久化以 CodeM 自己的 SQLite 为主，Claude transcript 作为导入与补录来源
• 模型内部隐藏思考链不会展示，界面只展示 Claude CLI 在 stream-json 中实际暴露的事件

• 开发规范入口：.trellis/workflow.md（后续非临时改动必须按 Trellis 记录任务、session、边界和验收）
• Trellis CLI：npm run trellis -- start <topic> --title "任务标题"，之后用 record、verify、complete 形成 session record 闭环
• frontend 规范：.trellis/spec/frontend/
• backend 规范：.trellis/spec/backend/
• 思考指南：.trellis/spec/guides/
• 开发任务沉淀：.trellis/tasks/
• 行为提案与变更记录：openspec/README.md
• 详细需求与演进路线：requirements.md
• 后续开发路线图：roadmap.md

CodeM 使用 MIT License 开源。