Skip to content

Repository files navigation

Lume — a private, local, open-source alternative to Warp

Latest release CI Downloads License: MIT Stars

A fast, lightweight, open-source alternative to Warp — command blocks, inline AI, panes, themes, remote control, and more. Built with Rust + Tauri 2 + SolidJS + xterm.js: a few-MB native binary, fully local, no account, no telemetry.

Platforms: Linux (X11 & Wayland), macOS (Intel & Apple Silicon) and Windows — built for all three on every release. macOS & Windows binaries are currently unsigned (a one-time first-launch prompt; see Install).

Screenshots

Command blocks
Command blocks — each command + output is a navigable block
Inline AI
Inline AI — explain a block or generate a command
Panes & themes
Panes, tabs & themes
Remote control
Remote control from your phone
Settings
Settings — appearance, shell, AI providers, file tree, shortcuts & more

Features

  • Command blocks — each command + its output is an isolated, navigable block (via shell integration / OSC 133), with exit-code badges, copy, rerun.
  • Inline AI — explain a block or generate a command from natural language. Multiple providers: the local Claude or Codex CLI, or any OpenAI-compatible API (OpenAI, DeepSeek, Ollama…). Pick per provider model.
  • Panes & tabs — splits, drag-and-drop rearrange, layout presets, full session persistence (tabs, panes, sizes, working dirs).
  • Autocomplete — inline suggestions from history, files, aliases, commands.
  • File tree sidebar that follows the active pane's directory, with customizable right-click commands.
  • Remote control — drive your terminals from your phone or another PC, on the LAN or over the internet (cloudflared quick tunnel), with QR pairing. The mobile page has a Termux-style key row, live directory completion, swipe-to-move-cursor, and a tab bar to switch/create terminals.
  • Themes & fonts — 9 built-in themes, custom font import, Nerd Font support, remappable keybindings, text zoom.
  • 14 languages — fully translated UI, switchable in settings (English default).
  • Desktop notifications when long commands finish in the background.
  • Self-updating on every platform, with signature-verified updates.

Install

Grab the installer for your OS from the latest release.

Linux x86_64

AppImage (any distro, auto-updating) — recommended

curl -fsSL https://raw.githubusercontent.com/hugomyb/Lume/main/scripts/install.sh | bash

This installs the latest AppImage and adds a menu entry. If it doesn't launch, install FUSE 2: sudo apt install -y libfuse2.

Debian / Ubuntu

Download Lume_*_amd64.deb from the latest release:

sudo apt install ./Lume_*_amd64.deb

Fedora / RHEL / openSUSE

sudo dnf install ./Lume-*.x86_64.rpm

Arch / Manjaro (AUR)

yay -S lume-bin       # or: paru -S lume-bin

macOS (Intel & Apple Silicon)

Download the universal Lume_*_universal.dmg, open it, and drag Lume to Applications. It's unsigned for now, so on first launch macOS will block it — right-click the app → Open (or System Settings → Privacy & Security → Open Anyway). After that it launches normally and auto-updates.

Windows

Download and run Lume_*_x64-setup.exe (NSIS installer). It's unsigned for now, so SmartScreen may warn — click More info → Run anyway. Updates install in-app afterwards.

Shell integration

For command blocks, autocomplete and cwd tracking, add the integration line to your shell config (Lume shows the exact line on first launch; the script is written to your config dir — ~/.config/lume/ on Linux/macOS, %APPDATA%\lume\ on Windows):

# ~/.zshrc  (or .bashrc / fish config.fish)
[[ -n "$LUME_TERM" ]] && source "$HOME/.config/lume/lume-shell-init.zsh"
# PowerShell — $PROFILE  (Windows)
if ($env:LUME_TERM) { . "$env:APPDATA\lume\lume-shell-init.ps1" }

Build from source

Requirements: Rust (stable), Node 20+, and the Tauri Linux deps:

sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev librsvg2-dev \
  libayatana-appindicator3-dev libxdo-dev patchelf

npm install
npm run tauri dev      # run in dev
npm run tauri build    # build bundles (target/release/bundle/)

Contributing

Contributions are welcome! See CONTRIBUTING.md for how to set up, build, run the checks, and open a pull request. By participating you agree to the Code of Conduct.

Security

Found a vulnerability? Please report it privately — see SECURITY.md. Do not open a public issue for security problems.

License

MIT © Hugo Mayonobe

About

Fast, lightweight, open-source terminal — a private, local alternative to Warp. Command blocks, inline AI, panes, themes & remote control. Built with Rust + Tauri.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages