English | 简体中文

⚡ Ultralytics Lite

Lite 是一个快速的本地工作区，支持 Claude Code、基于 OpenAI、DeepSeek、Z.ai、小米 MiMo 或 OpenRouter 的 Codex、Antigravity CLI、Kimi Code、Qwen Code 以及你的 shell。它把 agent 会话、文件和 Git 上下文放在一起，同时不做仓库索引、不采集遥测数据，也不依赖任何云服务。

✨ 功能

• 并排运行 Claude Code、Codex、Antigravity CLI、Kimi Code、Qwen Code 和 shell 会话
• 通过 Codex 使用 DeepSeek V4.1 Flash、Z.ai GLM-5.3、小米 MiMo-V2.6 或 OpenRouter，而无需更改默认的 Codex provider
• 重启或关闭后有八秒钟可以撤销，之后 Lite 才会停止终端
• 归档会话即可停止它并释放内存，之后在列表底部随时恢复
• 关闭 Lite 或重启电脑后，会话标签自动恢复
• 每个 provider 只需登录一次，之后复用其已有的本地凭据
• 也可以在 Lite 中为每个 provider 保存 API key，完全跳过登录流程
• 按需浏览带语言图标的文件树，并在编辑器中查找、替换与多光标编辑
• 在源码旁安全地预览渲染后的 Markdown
• 查看当前 Git 分支、worktree 和已更改文件
• 查看 Claude 或 Codex 上报的单会话上下文与用量
• 在 Lite 内安装带签名的更新
• 在浅色与深色主题之间切换，终端和代码预览一同跟随
• 在设置中随意重新绑定键盘快捷键

Lite 刻意保持安静：空闲就是空闲。它不索引你的仓库、不监视每个文件、不读取 provider 令牌，也不发送遥测数据。

📦 安装

从 最新 GitHub Release 下载 Lite。所有发行包由同一份源码为 macOS、Windows 和 Linux 构建。

macOS

1. 在 Apple 芯片 Mac 上下载文件名以 _darwin_aarch64.dmg 结尾的资源。
2. 打开磁盘映像，把 Lite 拖入 Applications。
3. 从 Applications 打开 Lite。如果 macOS 拦截了这个未签名的应用，打开 系统设置 → 隐私与安全性，把 允许以下来源的应用程序 设为 App Store 与已知开发者，为 Lite 选择 仍要打开，然后确认。

Windows

1. 下载文件名以 _windows_x64-setup.exe 结尾的资源。
2. 运行安装程序，然后从开始菜单打开 Lite。
3. 如果 Microsoft Defender SmartScreen 对这个未签名的应用弹出提示，选择 更多信息 → 仍要运行。

Linux

下载文件名以 _linux_amd64.AppImage 结尾的便携版资源。

# AppImage
chmod +x Lite_*_linux_amd64.AppImage
./Lite_*_linux_amd64.AppImage

安装 Lite 之后，点击顶栏的齿轮打开 设置，在“关于”中选择 Check for Updates，即可安装带签名的更新并重启 Lite。正式版启动后还会检查一次，并在版本徽标上显示结果；Lite 从不在未经你操作的情况下下载或安装更新。

🚀 首次运行

安装你需要使用的 provider CLI：

• Claude Code
• Codex
• Antigravity CLI
• Kimi Code —— Windows 还需要安装 Git for Windows
• Qwen Code

在 Lite 中打开每个 provider 并完成一次常规登录。每个 CLI 都把凭据保存在自己的本地存储中，因此之后的 Lite 会话会复用同一份认证信息。Lite 从不读取或复制这些存储。当某个 CLI 缺失时，新建会话对话框会为你安装它。

Lite 使用 Antigravity CLI 取代 Gemini CLI。Gemini CLI 会话仍由 Gemini CLI 保存；Antigravity 会创建自己的会话。

如果你更愿意使用 API key，打开 设置 › Accounts，选择 Add key，为支持的 provider 粘贴一个 key。Lite 会把它们保存在自己数据目录下仅属主可读的文件中——与 Codex 和 Kimi 保存自身凭据的方式一致——并通过该 CLI 本来就会读取的环境变量（ANTHROPIC_API_KEY、OPENAI_API_KEY、DEEPSEEK_API_KEY、ZAI_API_KEY、MIMO_API_KEY、OPENROUTER_API_KEY、GEMINI_API_KEY 或 MOONSHOT_API_KEY）把 key 传给会话。Qwen Code 自行负责其区域 provider 与认证设置。不会写入任何 provider 配置文件；删除 key 会在下次启动时生效；应用更新也不会丢失该文件，因为更新程序替换的是应用包而不是你的数据。

Codex · DeepSeek 使用 Codex 作为 harness，通过 OpenAI Responses API 运行 DeepSeek V4 Flash 或 Pro。在 Lite 中保存 DeepSeek key 即可——Lite 只会为该次启动定义这个 provider。如果你想自己配置，请使用你自己的 Codex 配置；在 $CODEX_HOME 中放一个 deepseek.config.toml profile 最为干净：

model = "deepseek-v4-flash" # 或使用能力最强的 "deepseek-v4-pro"
model_provider = "deepseek"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "<你的 DeepSeek API key>"

请不要写入 preferred_auth_method 和 forced_login_method。Codex 会全局应用这两项，一旦设置，下次运行时你会被登出 ChatGPT。Lite 只在每次启动时选择 DeepSeek provider，因此你的默认 Codex provider 和已有的 OpenAI 会话都不受影响，Lite 也不会读取或保存 DeepSeek key。

Codex · Z.ai 同样通过 Z.ai 的 Responses API 运行 GLM-5.3 与 GLM-5.3 Flash：在 Lite 中保存 Z.ai key，或者自行配置一个 ZAI provider —— base_url = "https://api.z.ai/api/v1"、wire_api = "responses"，并与 model = "glm-5.3" 放在一起。

Codex · 小米 MiMo 通过 MiMo 的 Responses API 运行 MiMo-V2.6-Flash 与 MiMo-V2.6-Pro：在 Lite 中保存 MiMo key，或者自行配置一个 mimo provider —— base_url = "https://api.xiaomimimo.com/v1"、wire_api = "responses"，并与 model = "mimo-v2.6-pro" 放在一起。Codex 自带 catalog 中并没有这些 provider 所提供的模型，因此 Lite 还会把一份基于内置 catalog 生成的模型列表交给 Codex：模型会带上正确的上下文窗口、推理等级和工具支持，而不是只得到一条元数据警告；你自己配置的 model_catalog_json 不会被覆盖。

选择一个项目文件夹，创建会话，然后开始工作。Lite 只保存恢复标签所需的本地元数据；provider 的对话历史仍归 provider CLI 所有。

🛠️ 开发

安装 Bun、Rust 以及对应平台的 Tauri 前置依赖，然后运行：

git clone https://github.com/ultralytics/lite
cd lite
bun install
bun run tauri dev

常用检查：

bun run check       # Biome 与原生 TypeScript 检查
bun run local       # 可直接双击运行、带红色图标的 Lite Dev 应用包
bun run tauri build # 为当前操作系统构建原生安装包

前端使用 React、shadcn/ui Nova（基于 Base UI）、Tailwind CSS、Biome 和 tsgo。Tauri 与 Rust 负责本地持久化、终端、Git、文件以及 provider 进程。

💡 贡献

欢迎在 GitHub Issues 提交 bug 报告和聚焦的功能建议。请记住 Lite 的核心原则：最简单且完整的方案胜出。

📄 许可证

Lite 基于 AGPL-3.0 许可证 提供。如需商业许可，请联系 Ultralytics Licensing。