2026-10-17 12:08:30 -05:00
|
|
|
---
|
|
|
|
|
title: "Overview"
|
2026-10-20 13:51:34 -05:00
|
|
|
summary: "What luxe is, and where to find what you need."
|
2026-10-17 12:08:30 -05:00
|
|
|
order: 0
|
|
|
|
|
group: "Get started"
|
|
|
|
|
---
|
|
|
|
|
|
2026-10-20 13:51:34 -05:00
|
|
|
luxe is a coding agent for your terminal. It works in your project with the model you choose,
|
2026-10-17 12:08:30 -05:00
|
|
|
then walks you through what it changed so you can review it and open a pull request without leaving
|
|
|
|
|
the terminal.
|
|
|
|
|
|
2026-10-20 13:51:34 -05:00
|
|
|
New to luxe? [Install](install.md) it, then follow the [Quickstart](quickstart.md). The rest of the
|
2026-10-17 12:08:30 -05:00
|
|
|
guide is reference, for when you need it.
|
|
|
|
|
|
|
|
|
|
## Find what you need
|
|
|
|
|
|
|
|
|
|
| To | Read |
|
|
|
|
|
| --- | --- |
|
|
|
|
|
| Connect a model, or switch between them | [Models and providers](providers.md) |
|
|
|
|
|
| Find your way around the screen | [The interface](interface.md) |
|
|
|
|
|
| Find a command or a key, or rebind one | [Commands and keys](commands.md) |
|
|
|
|
|
| Point the agent at a file, issue or skill | [Mentions](mentions.md) |
|
|
|
|
|
| Review what the agent changed | [Guided Review](guided-review.md) |
|
|
|
|
|
| Work from an issue, open or merge a pull request | [Git and GitHub](github.md) |
|
|
|
|
|
| Resume a session, or see what fills the context | [Sessions and context](sessions.md) |
|
|
|
|
|
| See what the agent can use | [Tools](tools.md) |
|
|
|
|
|
| Let the agent work through a plan on its own | [Autonomous runs](loop.md) |
|
2026-10-20 13:51:34 -05:00
|
|
|
| Reach your sessions from your phone or tablet | [luxe on your phone](remote.md) |
|
2026-10-17 12:08:30 -05:00
|
|
|
| Change the theme, keys or statusline | [Configuration](configuration.md) |
|
|
|
|
|
| Give the agent your project's conventions | [Project context](project-context.md) |
|
2026-10-20 13:51:34 -05:00
|
|
|
| Add tools, skills or your own commands | [Extending luxe](extending.md), [Recipes](recipes.md) |
|
2026-10-17 12:08:30 -05:00
|
|
|
| Control what the agent may do | [Security and permissions](security.md) |
|
|
|
|
|
| Look up a command, flag or environment variable | [Command line](cli.md), [Environment variables](environment.md) |
|
|
|
|
|
| Fix something that is not working | [Troubleshooting](troubleshooting.md) |
|
|
|
|
|
|
|
|
|
|
## Help
|
|
|
|
|
|
|
|
|
|
- **Help** (`/help`) lists every key for the screen you are on, with any you have rebound.
|
2026-10-20 13:51:34 -05:00
|
|
|
- `luxe doctor` checks which language servers, debuggers and tools luxe can use on your machine.
|
2026-10-17 12:08:30 -05:00
|
|
|
- [Troubleshooting](troubleshooting.md) covers common problems and how to report a bug.
|
|
|
|
|
- Problems and questions: [GitHub issues](https://github.com/evanwhittaker/luxe/issues).
|
|
|
|
|
|
2026-10-20 13:51:34 -05:00
|
|
|
## Ask luxe
|
2026-10-17 12:08:30 -05:00
|
|
|
|
2026-10-20 13:51:34 -05:00
|
|
|
This guide is built into luxe, for the version you have installed. Ask the agent how to do
|
|
|
|
|
something in luxe, such as *how do I add an MCP server?*, and it reads the answer from the guide
|
2026-10-17 12:08:30 -05:00
|
|
|
rather than guessing. You can read it yourself too:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
luxe docs # every page
|
|
|
|
|
luxe docs hooks # one page
|
|
|
|
|
luxe docs --search "on_ask"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## For agents
|
|
|
|
|
|
|
|
|
|
Every page is also plain markdown, at the same address with `.md` on the end:
|
|
|
|
|
`https://luxe.dev/docs/install.md`. [`llms.txt`](https://luxe.dev/llms.txt) lists every page with a
|
|
|
|
|
one-line summary, and [`llms-full.txt`](https://luxe.dev/llms-full.txt) is the whole guide in one
|
2026-10-20 13:51:34 -05:00
|
|
|
file. Inside luxe, `luxe docs` serves the same pages offline.
|