English | 简体中文

⚡ Ultralytics Lite

Lite is a fast, local workspace for Claude Code, Codex on OpenAI or DeepSeek, Kimi Code, and your shell. Keep agent sessions, files, and Git context together without repository indexing, telemetry, or a cloud service.

✨ Features

• Run Claude Code, Codex, Kimi Code, and shell sessions side by side
• Run Codex against DeepSeek when your Codex configuration provides that model
• Resume session tabs automatically after closing Lite or restarting your computer
• Authenticate once with each provider and reuse its existing local credentials
• Or save an API key per provider in Lite and skip the sign-in flows entirely
• Browse files on demand with syntax highlighting for popular languages
• Preview rendered Markdown safely alongside source files
• See the active Git branch, worktree, and changed files
• Inspect per-session context and provider usage reported by Claude or Codex
• Install signed updates from inside Lite
• Switch between light and dark themes, terminal and code preview included

Lite is intentionally quiet: idle means idle. It does not index your repository, watch every file, read provider tokens, or send telemetry.

📦 Install

Download Lite from the latest GitHub Release. Release assets are built from the same source for macOS, Windows, and Linux.

macOS

1. Download Lite_0.0.4_darwin_aarch64.dmg for an Apple silicon Mac.
2. Open the disk image and drag Lite into Applications.
3. Open Lite from Applications. If macOS blocks this first unsigned release, open System Settings → Privacy & Security, set Allow applications from to App Store & Known Developers, select Open Anyway for Lite, then confirm.

Windows

1. Download Lite_0.0.4_windows_x64-setup.exe.
2. Run the installer, then open Lite from the Start menu.
3. If Microsoft Defender SmartScreen appears for this early unsigned release, select More info → Run anyway.

Linux

Download the portable Lite_0.0.4_linux_amd64.AppImage.

# AppImage
chmod +x Lite_0.0.4_linux_amd64.AppImage
./Lite_0.0.4_linux_amd64.AppImage

After installing 0.0.4, open the Lite menu in the top bar and choose Check for updates to install signed updates and restart Lite. Lite never checks for updates in the background.

🚀 First Run

Install the provider CLIs you want to use:

• Claude Code
• Codex
• Kimi Code — Windows also needs Git for Windows

Open each provider in Lite and complete its normal sign-in once. Every CLI keeps credentials in its own local store, so later Lite sessions reuse the same authentication. Lite never reads or copies those stores. The new-session dialog tells you when a CLI is missing and links to its setup guide.

If you would rather use API keys, open API keys in the Lite menu and paste one per provider. Lite keeps them in an owner-only file in its own data folder — the same shape Codex and Kimi already use for their credentials — and passes a key to a session through the environment variable that CLI already reads (ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY, MOONSHOT_API_KEY). Nothing is written into provider configuration, deleting a key takes effect on the next launch, and app updates keep the file since the updater replaces the bundle and not your data.

Codex · DeepSeek runs the Codex harness against DeepSeek instead of OpenAI. Saving a DeepSeek key in Lite is enough — Lite then defines the provider for that launch only. To configure it yourself instead, use your own Codex configuration; a deepseek.config.toml profile in $CODEX_HOME is cleanest:

model = "deepseek-v4-flash"
model_provider = "deepseek"

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

Leave preferred_auth_method and forced_login_method out. Codex applies those globally, and setting them signs you out of ChatGPT the next time it runs. Lite selects the DeepSeek provider per launch, so your default Codex provider and existing OpenAI sessions are untouched, and it never reads or stores the DeepSeek key.

Choose a project folder, create a session, and work. Lite saves only the local metadata needed to restore tabs; provider conversation history remains owned by the provider CLI.

🛠️ Development

Install Bun, Rust, and the platform-specific Tauri prerequisites, then run:

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

Useful checks:

bun run check       # Biome and native TypeScript checks
bun run tauri build # Native installer for the current operating system

The frontend uses React, shadcn/ui Nova with Base UI, Tailwind CSS, Biome, and tsgo. Tauri and Rust own local persistence, terminals, Git, files, and provider processes.

💡 Contribute

Bug reports and focused feature proposals are welcome in GitHub Issues. Please keep Lite's core rule in mind: the simplest complete solution wins.

📄 License

Lite is available under the AGPL-3.0 License. For commercial licensing, contact Ultralytics Licensing.