MobiCodex

agent
Guvenlik Denetimi
Gecti
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.

SUMMARY

在手机上跟进、回复和审批电脑上的 Codex、Claude Code、DeepSeek、CC Desk、OpenCode 会话 · Android app to follow and steer your desktop coding agents

README.md
MobiCodex 图标

MobiCodex

人离开电脑,Agent 照样能接着干。
在手机上跟进、回复、审批电脑上的 Codex、Claude Code、DeepSeek、CC Desk 和 OpenCode 会话。

Android
Version
License

下载 · 三步上手 · 支持的 Agent · 更新说明 · 反馈问题

Codex 会话:工具摘要、代码块和最终结论 选择 Agent:Codex、Claude Code、DeepSeek、CC Desk 都在线 在手机上处理 Agent 的审批请求

为什么用它

Agent 一跑就是几十分钟,中间常常要你点一下审批、回答一个问题,或者看一眼结果再决定下一步。人不在电脑前,它就只能干等。MobiCodex 让这些事在手机上就能做完。

  • 会话跟着你走:电脑上正在跑的会话,在手机上按项目找到,实时看输出,接着发文字、图片和语音。
  • 需要你时才提醒:任务完成、等你审批或回答时,手机弹出通知,点开直接进入那条会话。
  • 用嘴派活:语音最长 10 分钟,边说边转文字,还能先整理成提示词再发出去。
  • 把活交出去,回来验收:用「事项」把工作交给指定的 Agent,进度自动回写成进行中、待验证,由你验收或退回。
  • 额度用完不断档:Codex 额度用完,在原线程里换个渠道接着做,上下文不丢。
  • 不用同一个 Wi-Fi:电脑网关主动连接你自己的 HTTPS Broker,手机在哪都能连,消息不经过第三方服务。

事项:进行中、待验证、已完成 深色模式下的 Codex 会话

支持的 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 的已知问题:

  • 其他 Agent 挂在 Codex 下面,顶栏按钮和“切换 Agent”入口不统一(#19)。
  • CC Desk 会话切屏回来后,恢复连接较慢(#20)。

开发与构建

目录 职责
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)

Sonuc bulunamadi