dnakov/litter

# litter

Codex 的原生 iOS + Android 客户端。连接到本地或远程服务器，管理会话，并在手机上运行 agentic coding 工作流。

   

## 截图 (iOS)

## 快速开始 ``` make ios-device-fast # fast device build make ios-sim-fast # fast simulator build make android-emulator-fast # fast Android emulator build ``` 有关前置条件、完整的构建选项、TestFlight/App Store 发布以及 SSH 设置，请参阅 [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)。 ## 仓库结构 ``` apps/ios/ iOS app (Litter scheme, project.yml is source of truth) apps/android/ Android app (Compose UI, Gradle build) shared/rust-bridge/ codex-mobile-client/ Shared Rust client crate + UniFFI surface (iOS & Android) codex-ios-audio/ iOS-only audio/AEC crate shared/third_party/codex/ Upstream Codex submodule patches/codex/ Local patch set applied during builds tools/scripts/ Cross-platform helper scripts ``` ## 架构 两个平台通过 UniFFI 生成的绑定共享单个 Rust 核心（`codex-mobile-client`）。平台代码（Swift/Kotlin）保持精简：仅包含 UI、权限、通知和平台 API。会话状态、流式传输、hydration、服务发现和身份验证逻辑均位于 Rust 中。 ## 贡献 Litter 正在积极开发中，许多功能正在同步推进。我们欢迎提交 PR，但通常只有那些规模较小且针对特定问题的 PR 才可能被合并——大规模的重构和新功能往往会与正在进行中的工作发生冲突。在提交 PR 之前，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。 ## 许可证 Litter 采用 GNU General Public License version 3 授权，并根据 GPLv3 第 7 条为 Apple App Store 和 Google Play 分发提供了额外许可。请参阅 [LICENSE](LICENSE)。 ## Make 目标 | 目标 | 描述 | |---|---| | `make ios-device-fast` | 快速设备构建（原始 staticlib） | | `make ios-sim-fast` | 快速模拟器构建 | | `make ios` | 完整打包流程（设备 + 模拟器 + xcframework） | | `make android-emulator-fast` | 快速 Android 模拟器构建 | | `make android` | 完整 Android 流水线 | | `make rust-check` | 针对共享 Rust crates 执行宿主机 `cargo check` | | `make rust-test` | 针对共享 Rust crates 执行宿主机 `cargo test` | | `make bindings` | 重新生成 UniFFI Swift + Kotlin 绑定 | | `make xcgen` | 从 `project.yml` 重新生成 Xcode 项目 | | `make clean` | 移除所有构建产物 |

标签：AEC, Agentic Coding, AI编程, Android应用, App Store, DNS解析, Generative UI, Git安全, iOS应用, Jetpack Compose, Kotlin, OpenAI Codex, Rust桥接, Rust语言, SSH连接, Swift, TestFlight, UniFFI, 代理工作流, 代码生成, 会话管理, 可视化界面, 后台面板检测, 多平台开发, 威胁情报, 实时语音交互, 开发者工具, 开源客户端, 开源项目, 渗透测试工具, 移动客户端, 移动应用开发, 移动端AI开发工具, 编程工具, 远程代码执行, 通知系统, 音频处理