中文 | English

Codex Android

📱 让 AI Agent 真正"活"在手机里 —— 系统级集成 + CLI 工具链，操控任何 Android APP 📱

---

🌟 项目简介

Codex Android 将 Codex AI Agent 移植到 Android 平台，让 AI 不再是"聊天框里的文字"，而是能实际操作手机的智能代理。通过 CLI-first 架构和系统级集成，Codex 可以操控文件、管理应用、控制设置、调用第三方 APP——就像人类操作手机一样，但通过结构化的命令行接口。

核心理念：Android 本身就是最丰富的 CLI 平台。Codex Android 将这一理念落地，基于 CLI-Anything 方法论，为 Android 系统和 APP 生成 Agent-Native 的 CLI harness。

---

⚡ 核心亮点

🤖 AI Agent on Mobile Codex AI 完整运行在 Android 设备上，支持多模型后端（OpenAI / Claude / Gemini / 本地模型），具备工具调用、记忆、推理能力 🔧 CLI-First 架构 通过标准化 CLI 接口操控整个手机：文件系统、应用管理、系统设置、网络、多媒体、通知——全部结构化 + JSON 输出 🎯 APP 操控能力 通过 Intent 桥接 / ContentProvider / AccessibilityService，Codex 可以操控微信、日历、浏览器等第三方 APP

🧠 记忆与上下文 智能记忆系统，自动分类、搜索、关联历史对话，支持时间查询和导入导出 🔌 可扩展生态 支持 MCP / Skill 插件、工作流自动化、定时任务、语音触发，与 CLI-Anything 生态互通 🛡️ 隐私优先 所有核心功能本地运行，敏感数据不出设备，权限最小化原则

---

🛠️ 开发路线图

Phase 1：APK 编译通过（当前） 🔴

• 解决 Kotlin 2.2.21 类型推断退化问题（详见 BUILD_LOG.md）
• 修复 CI/CD 管道问题
• 生成可安装的 APK

Phase 2：Android System CLI Harness

• 系统级 CLI 命令（应用管理、文件系统、网络、多媒体、通知）
• JSON 结构化输出
• Shizuku/Root 权限集成

Phase 3：APP 级 CLI 适配

• Intent 桥接层（零侵入操控第三方 APP）
• ContentProvider 包装
• 源码级 Harness 生成（开源 Android APP）

Phase 4：CLI-Hub 生态集成

• CLI-Hub 包管理器
• SKILL.md 标准
• 社区贡献体系

📖 完整路线图：ANDROID_CLI_ROADMAP.md

---

🚀 快速开始

⚠️ 当前状态：编译适配中，尚无可用 APK。 详见 BUILD_LOG.md。

项目	说明
📋 系统要求	Android 8.0+ (API 26+)，建议 4GB+ 内存
🔧 开发环境	Android Studio + Kotlin 2.2.21 + Gradle 8.x
📖 文档	编译日志 · 路线图

---

👨‍💻 开源共创

项目处于早期开发阶段，欢迎贡献！

• 📚 贡献指南
• 🐛 提交 Issue

---

📄 致谢

• CLI-Anything — Agent-Native CLI 方法论
• Codex — 上游 AI Agent 项目

---

📄 许可证

本项目采用 GNU LGPLv3 许可证。

---

_{Made with ❤️ by the Codex Android Team}