A stable, secure alternative fork of Lightweight. Security fixes, bug fixes, and improvements beyond upstream — all thoroughly reviewed before merging. Includes custom model registry with additional AI models (Gemini 3.1 Pro, Claude Opus 4.6, GPT-5.3 Codex). Available as Desktop app and CLI (lightweight-ai on NPM).

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська

---

Installation

npm i -g lightweight-ai@latest        # or bun/pnpm/yarn

Tip

Remove versions older than 0.1.x before installing.

Desktop App (BETA)

Lightweight is also available as a desktop application. Download directly from the releases page.

Platform	Download
macOS (Apple Silicon)	lightweight-desktop-darwin-aarch64.dmg
macOS (Intel)	lightweight-desktop-darwin-x64.dmg
Windows	lightweight-desktop-windows-x64.exe
Linux	.deb, .rpm, or AppImage

Or download binaries directly from the releases page.

Installation Directory

The install script respects the following priority order for the installation path:

1. $LIGHTWEIGHT_INSTALL_DIR - Custom installation directory
2. $XDG_BIN_DIR - XDG Base Directory Specification compliant path
3. $HOME/bin - Standard user binary directory (if it exists or can be created)
4. $HOME/.lightweight/bin - Default fallback

# Examples
LIGHTWEIGHT_INSTALL_DIR=$HOME/.local/bin ./install
XDG_BIN_DIR=$HOME/.local/bin ./install

Agents

Lightweight includes two built-in agents you can switch between with the Tab key.

• build - Default, full-access agent for development work
• plan - Read-only agent for analysis and code exploration
  • Denies file edits by default
  • Asks permission before running bash commands
  • Ideal for exploring unfamiliar codebases or planning changes

Also included is a general subagent for complex searches and multistep tasks. This is used internally and can be invoked using @general in messages.

Learn more about agents.

Documentation

For more info on how to configure Lightweight, check the GitHub repository.

Contributing

If you're interested in contributing to Lightweight, please read our contributing docs before submitting a pull request.

What's different from Lightweight?

Lightweight is a stable fork of Lightweight with the following improvements:

• Improved GitHub Copilot authentication (token exchange via gh CLI, dynamic proxy endpoint, 3-tier fallback)
• Desktop application with builds for Windows, macOS (ARM + Intel), and Linux
• Automated fork sync to stay up-to-date with upstream Lightweight
• Custom model registry with additional AI models

All upstream Lightweight features are preserved — provider-agnostic model support, LSP integration, TUI, client/server architecture.

---

About

Lightweight is a stable fork of Lightweight maintained by templarsco.