코덱스플로우

CodexFlow 是一個面向 Codex CLI 的콘솔 客户端.

它的목표는 "远程看终端",而是把 Codex 的会话、turn、diff、审批、状态流,整理成一套适合手机和轻量客户端管理的控制平面。

当前已经支持两条主要 Agent 链路:

• '코덱스'
• '클로드 코드'

当前仓库包含三部分：

• 'Go Agent':运行在本地컴퓨터上的서비스,负责接入 Codex CLI
• 'iOS App':运行在 iPhone 上的 SwiftUI 客户端,负责监控、审批和继续指挥
• 'Flutter App':새로운 跨平台 客户端,负责 Android / Web / 桌面端接入同一套 Agent API

工作原理

CodexFlow 不依赖 OCR,也不是去截图识别终端。

它직접 접在 'codex app-server' 之上,通过结构化协议拿到真实的会话和执行状态,再转成适合移动端消费的 API.

整体链路如下：

这套设计的核心点是：

• 'Go Agent' 负责把 Codex 的原始协议适配成稳定的应用层接口
• 客户端不直接操纵终端，而是操纵会话本身
• “自动发现已有会话”和“受控管理新会话”可以同时存在
• 对 'Claude Code' 会추가 분류 '역사导入' 和 '可接管 런타임'

当前已实现的功能

가자, 요원

• 직접 启动并连接 'codex app-server'
• 자동 发现真实的 Codex 历史会话
• 자동 발견 Claude 역사 transcript 与本机 라이브 런타임
• 읽음 'thread/list', 'thread/read', 'thread/loaded/list'
• 支持新建受控会话
• 支持重新接管历史会话
• 지지开始新 turn, steer 当前 turn, interrupt 当前 turn
• 支持结束会话、归档会话
• 捕获命令审批、文件变更审批、权限审批、结构化用户输入请求
• 对外제공 HTTP API 和 SSE 사건流

iOS 앱

• 会话总览页
• 已接管 / 已结束 / 可接管 Runtime / 历史导入分组
• 总会话、已加载、运行中、待审批统计
• 会话详情页
• plan / diff / timeline 展示
• 继续下一步, steer, interrupt
• 审批中心
• Agent 地址配置
• 只显示真实数据,不再回退 mock 数据

플러터 앱

• 复用同一套 Agent HTTP API
• 会话总览页
• 会话详情页
• 审批中心
• 设置页 / Agent 地址配置
• Claude 会话显示 'History / Runtime' 与 '现有 Runtime / 历史新开 / 新建 Runtime' 状态
• Android / Web / 桌面端 runner 已补齐
• 已适配浏览器跨域访问本地 Agent

当前支持的端

• 'Go Agent':Windows, Linux, macOS (go原生支持多端)
• '客户端 지지플랫폼':Windows, Linux, macOS, iOS, Android, Web
• 'iOS SwiftUI 앱': iOS
• 'Flutter 앱': Windows, Linux, macOS, iOS, Android, Web

当前已验证可用的

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.