MobiCodex
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 11 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
在手机上跟进、回复和审批电脑上的 Codex、Claude Code、DeepSeek、CC Desk、OpenCode 会话 · Android app to follow and steer your desktop coding agents
MobiCodex
人离开电脑,Agent 照样能接着干。
在手机上跟进、回复、审批电脑上的 Codex、Claude Code、DeepSeek、CC Desk 和 OpenCode 会话。
为什么用它
Agent 一跑就是几十分钟,中间常常要你点一下审批、回答一个问题,或者看一眼结果再决定下一步。人不在电脑前,它就只能干等。MobiCodex 让这些事在手机上就能做完。
- 会话跟着你走:电脑上正在跑的会话,在手机上按项目找到,实时看输出,接着发文字、图片和语音。
- 需要你时才提醒:任务完成、等你审批或回答时,手机弹出通知,点开直接进入那条会话。
- 用嘴派活:语音最长 10 分钟,边说边转文字,还能先整理成提示词再发出去。
- 把活交出去,回来验收:用「事项」把工作交给指定的 Agent,进度自动回写成进行中、待验证,由你验收或退回。
- 额度用完不断档:Codex 额度用完,在原线程里换个渠道接着做,上下文不丢。
- 不用同一个 Wi-Fi:电脑网关主动连接你自己的 HTTPS Broker,手机在哪都能连,消息不经过第三方服务。
支持的 Agent
所有 Agent 共用同一套会话界面:输入框、附件、语音、草稿和运行中的操作都一样,按钮按各通道实际支持的能力显示。
| Agent | 在手机上能做什么 |
|---|---|
| Codex 桌面端 | 查看并继续电脑上的会话;文字、图片、语音;审批、回答提问、停止;额度用完原线程换渠道 |
| Claude Code | 打开已加载插件的会话,看输出、排队输入、审批、回答提问、中断 |
| DeepSeek Harness | 查看电脑上的会话和历史,继续原线程,回答提问 |
| CC Desk | 查看 CC Desk 会话,发消息、审批、中断 |
| OpenCode | 打开现有会话,看输出、回答提问 |
新的 Agent 只要实现标准的 SessionAdapter,就能直接用上这套界面,见其他 Agent 接入。
下载
| 文件 | 说明 |
|---|---|
| Android APK 0.3.1(下载页) | Android 6.0+,可直接覆盖安装旧版 |
| GitHub Release | 同一份源码由 GitHub Actions 构建,附校验值 |
| 版本说明 | 本版内容、签名说明和安装步骤 |
装好以后在「设置 → 应用更新」检查更新。只改界面的更新会在后台下载,下次打开时生效,不用重装。
从 Kelivo 整合版(0.1.x)换过来:两者是不同的应用,可以同时安装。按下面的步骤重新配对一次,确认正常后再卸载旧版。Kelivo 里的 AI 聊天记录和手机上保存的语音转写记录不会迁移。
三步上手
电脑上需要运行 Codex 桌面端和本项目的网关;手机不在同一个 Wi-Fi 时,还需要一台你自己的 HTTPS Broker(部署说明)。
1. 在电脑上装好网关
git clone https://github.com/luoz76070-art/MobiCodex.git
cd MobiCodex
corepack pnpm install --frozen-lockfile
corepack pnpm build:plugin
node dist-plugin/mobile-codex/scripts/mobile-codex.mjs init --workspace /absolute/path/to/your/project
2. 填好 Broker 配置后启动,生成配对信息(配置项见网关说明)
node dist-plugin/mobile-codex/scripts/mobile-codex.mjs start
node dist-plugin/mobile-codex/scripts/mobile-codex.mjs pair
3. 在手机 App 的「设置」里粘贴配对信息,连上后选择会话即可。pair 只生成短期有效的配对信息,不调用模型。
已经配置过的电脑,先运行 mobile-codex.mjs status,沿用原来的配置和工作目录。要接 CC Desk,见 CC Desk 接入。
工作原理
flowchart LR
P["MobiCodex(手机)"] -- HTTPS --> B["你的 Broker"]
G["电脑网关"] -- 主动连接 --> B
G --> C["Codex 桌面端"]
G --> A["Claude Code / DeepSeek / CC Desk / OpenCode"]
网关跑在你的电脑上,主动连到 Broker,电脑不用开放端口。手机经 Broker 和网关通信,配对后才能访问;本地图片也要经过网关鉴权才能取到。
反馈问题
遇到问题请提到 GitHub Issues,写清手机型号、App 版本和复现步骤。
0.3.1 的已知问题:
开发与构建
| 目录 | 职责 |
|---|---|
apps/mobile |
MobiCodex Android App:React 页面 + Capacitor 原生壳(录音、更新、凭据、系统栏与取色) |
apps/relay |
Fastify API、Codex Desktop IPC、Broker 与 Tunnel |
plugins |
电脑网关及其他 Agent 的接入包 |
apps/kelivo、integrations/kelivo、releases/android/kelivo-preview |
已停止的 Kelivo 整合版(0.1.x)源码、构建契约与历史发布 |
Node.js 22+、pnpm 10.20.0;Android 构建需要 Android SDK 35 与 JDK 21+(lint 用 JDK 17)。
corepack pnpm install --frozen-lockfile
corepack pnpm verify
corepack pnpm --filter @mobile-codex/mobile build
corepack pnpm --filter @mobile-codex/mobile exec cap sync android
gradle --project-dir apps/mobile/android :app:assembleRelease
构建前在 apps/mobile/.env.production.local 配置 App 内更新与界面更新的清单地址(见 apps/mobile/scripts/check-update-sources.mjs)。发布由推送 mobicodex-v<版本> 标签触发 Android 发布工作流。自己的构建签名与下载页的预览证书不同,不能覆盖安装下载页的版本。
致谢与许可
MobiCodex App 与电脑网关源自 Codex To Phone,按 MIT 许可 发行。App 内置 @material/material-color-utilities 的一小部分(Apache-2.0,见 apps/mobile/src/vendor/material-color-utilities),用于和系统动态取色保持一致。各依赖沿用其原许可。
0.1.x 整合版的 AI 部分来自 Chevey339/Kelivo(固定 v1.3.4 / 4a7da9b6),按随附 GNU AGPL v3 发行;这些历史版本的源码归档、来源与修改清单见 integrations/kelivo。感谢 Kelivo 及其贡献者。
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi