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.
This commit is contained in:
Evan Whittaker
2026-10-20 13:51:34 -05:00
parent 6184aa21fb
commit a0666d6c81
591 changed files with 4926 additions and 2942 deletions

View File

@@ -1,6 +1,6 @@
---
title: "Troubleshooting"
summary: "Common problems, where Luxe logs, and what to include in a bug report."
summary: "Common problems, where luxe logs, and what to include in a bug report."
order: 4
group: "Reference"
---
@@ -11,23 +11,23 @@ group: "Reference"
luxe doctor
```
It lists the tools, language servers and debug adapters Luxe found, starts each language server to
It lists the tools, language servers and debug adapters luxe found, starts each language server to
check that it works, and shows how to install or fix what does not.
## Common problems
| Problem | Fix |
| --- | --- |
| **No model selected**, or `--headless` refuses to start | Choose one with `/model`, or pass `--model provider/id`. Luxe never picks one for you. |
| **No model selected**, or `--headless` refuses to start | Choose one with `/model`, or pass `--model provider/id`. luxe never picks one for you. |
| The model picker is empty | No provider is set up. Open **Configuration** (`c`), or set a provider's key in the environment. |
| A provider keeps failing with `retrying (3/3)` | It is overloaded or unreachable. See [When a provider stalls](providers.md#when-a-provider-stalls) for the time limits. |
| A setting does nothing | Luxe ignores keys it does not know, so check the spelling. `luxe init` and `/settings` write a `config.schema.json` your editor can check against. A project's file cannot change some settings; see [Configuration](configuration.md#what-a-project-cannot-change). |
| A setting does nothing | luxe ignores keys it does not know, so check the spelling. `luxe init` and `/settings` write a `config.schema.json` your editor can check against. A project's file cannot change some settings; see [Configuration](configuration.md#what-a-project-cannot-change). |
| Icons show as boxes, or sit flush against their words | See [Fonts](install.md#fonts), and the `glyphs` setting in [Appearance](appearance.md#icons-and-fonts). |
| Your terminal's copy key does nothing | The terminal keeps it. Hold `shift` while dragging, or let the key pass through; see [Mouse and clipboard](interface.md#mouse-and-clipboard). |
| Images do not appear | Your terminal may not draw them. `/images` says why; see [Images](appearance.md#images). |
| A language server is not used | `luxe doctor` says whether it starts. A server a project installed is used only when you are watching; see [Tools](tools.md#a-server-the-project-installed). |
| A project's hooks or MCP servers do not run | They need `--trust-project`, or an interactive session for MCP servers. See [Security](security.md#untrusted-repositories). |
| Luxe opened the wrong folder as the project | Inside a repository, a `.luxe/` between you and its top scopes the project there. Remove it, or start Luxe somewhere else. See [Where the project begins](project-context.md#where-the-project-begins). |
| luxe opened the wrong folder as the project | Inside a repository, a `.luxe/` between you and its top scopes the project there. Remove it, or start luxe somewhere else. See [Where the project begins](project-context.md#where-the-project-begins). |
| `/pr` or `/github` says GitHub is unavailable | Install the GitHub CLI and sign in: `gh auth login`. A private repository also needs `gh auth setup-git`. |
| A key binding does not work | Your terminal may not send that key. Rebind it; see [Commands and keys](commands.md#rebind-keys). |
| On a Mac, some `alt` keys type a character such as `ø` or `π` | Your terminal treats Option as a key that types characters. Set it to act as Alt; see [Alt keys on a Mac](commands.md#alt-keys-on-a-mac). |
@@ -38,9 +38,9 @@ A session logs to `.luxe/logs/luxe.log` in the project. Commands that only repor
`luxe auth`, `luxe doctor` and `luxe models`, log to `logs/luxe.log` in the state directory:
`~/.local/state/luxe/` (`%LOCALAPPDATA%\luxe\` on Windows), or wherever `LUXE_STATE_DIR` or
`XDG_STATE_HOME` puts it. On macOS and Linux, a log is readable only by you. One past 5 MB is moved
to `luxe.log.1` the next time Luxe starts, replacing the one before.
to `luxe.log.1` the next time luxe starts, replacing the one before.
The log shows Luxe's own activity at `info` and everything else at `warn`. For more:
The log shows luxe's own activity at `info` and everything else at `warn`. For more:
```bash
LUXE_LOG=debug luxe # everything
@@ -49,7 +49,7 @@ LUXE_LOG=luxe_core::hooks=debug luxe # one part, in detail
## See what is sent to the model
`LUXE_WIRE_LOG` records every request Luxe sends and every reply, with credentials removed.
`LUXE_WIRE_LOG` records every request luxe sends and every reply, with credentials removed.
`luxe wire` summarizes it: what fills each request, whether the cached part stays the same between
turns, and whether anything is sent twice.
@@ -70,7 +70,7 @@ Open an issue at [github.com/evanwhittaker/luxe](https://github.com/evanwhittake
- The relevant part of `.luxe/logs/luxe.log`
If the interface itself draws wrongly, such as stray characters or a half-drawn screen, record the
raw output, which shows what Luxe actually wrote:
raw output, which shows what luxe actually wrote:
```bash
script -f /tmp/luxe.tty -c luxe # replay with `cat` or `scriptreplay`