Luxe is a coding agent for your terminal, written in Rust. It works in your project with the model you choose, then reads back what it changed as a Guided Review, so you can comment, ask for fixes, and open the pull request without leaving the terminal.
One take on Claude Sonnet 5.5, with only the waits cut: it writes todo overdue with a test, the
change is read back in three chapters, and the pull request is drafted from the review.
What it does
- Guided Review. A change is read back to you in chapters, each saying what changed, why, and how it was checked, beside the code. Comments go to the agent as work, and finishing turns the review into commits, a pull request or a stack of them. It reads someone else's pull request the same way.
- GitHub from the terminal, through your own
gh: start from an issue in a worktree of its own, see the branch's checks and threads in the dock, answer review threads, merge, restack. - Plan, then build. Plan mode is held in code: it reads, asks, and writes only
PLAN.md.luxe loop startthen works through the plan phase by phase, and a phase counts only once the commands you set pass and, if you ask for one, a reviewer in a fresh context agrees. - Tools that beat the shell.
testreports each failure with itsfile:line; every edit comes back with the errors a language server found in it;debugdrives a real debugger;impactnames the callers and tests a change reaches. luxe.dev/tools measures each against the command it replaces. - Guardrails that stay on. Every tool call is allowed, asked about or denied by rules you can
read. Reading
.env, wiping your home folder and running as root are refused unless you allow them yourself or say--yolo, and a repository cannot grant itself trust: its hooks and gate commands wait for--trust-project, and the servers it brings start only while you are watching. - The cache holds. The system prompt is byte-identical between turns, so a provider's prompt
cache keeps working.
/costshows what was read from it, andLUXE_WIRE_LOGplusluxe wireshows you every byte sent. - Scriptable.
luxe --headless --model provider/id -p "…"runs one prompt and exits 1 when the turn fails, and--format jsonstreams its messages, tool calls and each call's token usage. With nobody to answer, a call that would ask is allowed;--on-ask denyrefuses it instead.luxe --rpcspeaks the whole protocol. - Extended with files and programs, never code loaded into Luxe: skills, hooks, MCP servers,
your own
@sources, and an RPC protocol for driving Luxe from your own program.
Luxe connects to 24 providers and any OpenAI-compatible endpoint. Sign in with a ChatGPT or GitHub Copilot subscription or an OpenRouter account, or bring an API key; Anthropic and Google take API keys only. There is no telemetry: every connection Luxe makes is one you asked for or can turn off, and the guide lists them.
Install
# macOS and Linux
curl -fsSL https://luxe.dev/install.sh | sh
# Homebrew
brew install evanwhittaker/tap/luxe
# Cargo (Rust 1.89 or newer)
cargo install --locked luxe-cli
# Windows (PowerShell)
powershell -c "irm https://luxe.dev/install.ps1 | iex"
To update, run luxe update. To build from source:
git clone https://github.com/evanwhittaker/luxe.git
cd luxe
cargo build --release
./target/release/luxe --version
Luxe runs on Linux, macOS and Windows, in any UTF-8 terminal; on Windows, use Windows Terminal and
install Git for Windows so the agent has a POSIX shell. You also need
a model to talk to: an API key or a subscription. Your settings and credentials live in
~/.config/luxe/ (%APPDATA%\luxe on Windows).
Icons come from a Nerd Font when you have one, in its Mono build; without one, Luxe draws plain characters, and every icon has a word beside it. See Fonts.
Luxe uses these when they are installed, and works without them:
| For | |
|---|---|
| Git | Reviewing changes, and worktrees |
The GitHub CLI, gh, signed in |
Issues and pull requests |
| A language server per language | Errors after each edit, definitions and references |
| A debug adapter per language | The debug tool |
| ast-grep | Search and replace by code structure |
luxe doctor checks which of them Luxe can use on your machine, and how to install the rest.
Quickstart
-
Start in your project, on a branch of its own.
cd your-project git switch -c my-change luxeluxe --worktreedoes the same in a worktree, so your checkout is never touched. -
Answer setup. The first launch asks for a theme, a provider, which tools the agent can use, and what Luxe opens on. Sign in with a subscription or paste an API key; a key already in your environment, such as
ANTHROPIC_API_KEY, is found on its own. Choose a model when the picker opens. -
Ask for something. Type it and press
enter. Each step the agent takes appears as a card; type while it works to steer it, andctrl+escstops the turn. -
Review it. Press
ctrl+g. Whenreview readyshows, press it again:spacesteps through the change,ccomments on a line,aasks the agent about it. -
Ship it.
alt+enterfinishes the review. Choose Request fixes to send your comments, or, with the GitHub CLI signed in (gh auth login), Open pull request, drafted from the review.
luxe -c picks up your last session. ctrl+k opens the Command Palette, /help lists every key
on the screen you are on, and ctrl+c quits; the session is already saved. The
Quickstart walks through the same steps with pictures.
Documentation
The guide is at luxe.dev/docs, and built into Luxe for the version you
have: luxe docs, luxe docs hooks, luxe docs --search "on_ask". Ask the agent how to do
something in Luxe and it reads the answer from the same pages.
| To | Read |
|---|---|
| Connect a model, or switch between them | Models and providers |
| Find your way around the screen | The interface |
| Find a command or a key, or rebind one | Commands and keys |
| Review what the agent changed | Guided Review |
| Work from an issue, open or merge a pull request | Git and GitHub |
| Let the agent work through a plan on its own | Autonomous runs |
| See what the agent can use | Tools |
| Give the agent your project's conventions | Project context |
| Change the theme, keys or statusline | Configuration |
| Control what the agent may do | Security and permissions |
| Add tools, skills, hooks or your own front end | Extending Luxe |
| Look up a flag or an environment variable | Command line, Environment variables |
| Fix something that is not working | Troubleshooting |
Every page is also plain markdown in docs/guide/, and
llms.txt lists them for an agent.
Contributing
CONTRIBUTING.md has the gate, the architecture, the Windows checks and how
the site and the demos are made; AGENTS.md has the rules an agent working here holds
to. Problems and questions go to GitHub issues.
Luxe is built with AI assistance, much of it Luxe working on itself. Every change still passes the full test suite and CI before it merges, and its maintainer decides what does. If AI helped with yours, say so.
Luxe draws on Pi, by earendil-works, and on OpenCode, and on the unidirectional data flow of Elm and Ratatui.
License
Licensed under either of MIT or Apache-2.0, at your option. Unless you say otherwise, a contribution you submit is licensed the same way, without further terms.

