Files
luxe/docs/guide/index.md
Evan Whittaker a0666d6c81 luxe 0.1.4: remembered models, wheel-driven lists, and a steadier phone app
- luxe starts on the model you last chose in this project, then the last one anywhere. Signing in
  opens the model picker instead of choosing for you.
- Every list in a modal takes the mouse wheel and a draggable scrollbar.
- The phone app shows reasoning in full, stays put while you read back through a long session, and
  shows a question's answer on its card.
- On Windows, luxe update replaces the running luxe, and a signed-in install no longer sees setup
  again.
- The file tree no longer shows "engine busy" in a large project, loop output is easier to follow,
  and the name is written lowercase.

The CHANGELOG has the full list.
2026-10-20 13:51:34 -05:00

61 lines
2.8 KiB
Markdown

---
title: "Overview"
summary: "What luxe is, and where to find what you need."
order: 0
group: "Get started"
---
luxe is a coding agent for your terminal. It works in your project with the model you choose,
then walks you through what it changed so you can review it and open a pull request without leaving
the terminal.
New to luxe? [Install](install.md) it, then follow the [Quickstart](quickstart.md). The rest of the
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) |
| Reach your sessions from your phone or tablet | [luxe on your phone](remote.md) |
| Change the theme, keys or statusline | [Configuration](configuration.md) |
| Give the agent your project's conventions | [Project context](project-context.md) |
| Add tools, skills or your own commands | [Extending luxe](extending.md), [Recipes](recipes.md) |
| 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.
- `luxe doctor` checks which language servers, debuggers and tools luxe can use on your machine.
- [Troubleshooting](troubleshooting.md) covers common problems and how to report a bug.
- Problems and questions: [GitHub issues](https://github.com/evanwhittaker/luxe/issues).
## Ask luxe
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
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
file. Inside luxe, `luxe docs` serves the same pages offline.