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:
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user