- 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.
3.8 KiB
3.8 KiB
luxe's voice
How luxe sounds anywhere a person reads it: the TUI, the phone app, the site, the guide, --help,
errors and release notes. How the agent talks is set in luxe-core::context, not here.
In one line: plain, direct and warm. luxe sounds confident because it's good, not because it says so.
Principles
- Say it plainly. Short words, short sentences. "Start", not "initiate". If a word can go, it goes. Read it out loud: if you wouldn't say it to a friend at their desk, rewrite it.
- Lead with what matters. The point first, then the detail.
- Talk to one person. "You". Never "we" or "users".
- Show, don't boast. A fact beats an adjective: "Works with over 8,000 models", not "Works
with all the best models". CI fails on the marketing words listed in
scripts/voice-check.py. - Use the real name. Feature names, git terms and key names are what people search for. Explain one if you have to; don't swap it for a cuter word.
- Don't oversell the model. luxe drives models; it isn't one. Talk about what luxe does: what the model sees, what it can touch, how you review what it did.
- Have some fun, in the right places. Wordplay belongs in headlines and empty states: "As good as it gits.", "Get excited." Never in errors, buttons, permission prompts or anything read when something's gone wrong. One per screen at most.
UI text
The TUI and the phone app use labels, not sentences. People glance at UI; they don't read it.
| What | Do | Don't |
|---|---|---|
| Button | Review changes |
Click here to review your changes |
| Key hint | ctrl+g to review |
Press ctrl+g to open a review of what changed. |
| Status | Compacting |
luxe is now compacting your conversation… |
| Empty state | No sessions yet. Run luxe in a project to start one. |
Nothing to see here! |
| Error | No shell found. Install Git for Windows and try again. |
Oops! Something went wrong. |
- Buttons start with a verb: Send, Allow once, Review.
- Sentence case for titles and buttons:
Command palette. - Keys in lowercase, the way the TUI draws them:
ctrl+p,alt+enter,esc. A capital means Shift, soGis Shift+G. - No period on labels, hints or status. A full sentence in a message gets one.
- Errors say what happened, then what to do. No "oops", no "sorry", no blame.
- Empty screens say what to do next.
- One word per thing. Once something has a name, use it everywhere.
The site
- Headlines are short statements, with a period: "A better way to build."
- Body copy is two or three sentences, then show it. A screenshot beats a paragraph.
- Numbers come from the source (
facts.json), never typed by hand.
The guide
People read docs/guide/ mid-task, and so do the agents they point at it.
- Answer the question: how do I, what does, where is. History goes in commit messages.
- Headings name the task: "Add an MCP server".
- A table for options, a list for steps, prose only for what neither can carry.
- Name the feature, then its default key: the Command Palette (
ctrl+k). Keys can be rebound; names can't. - Every config example names its file in the fence:
```json title="~/.config/luxe/config.json". A test loads it as that file. - Links name the file,
configuration.md#github, so they work on GitHub, the site and in the terminal. No "see above": link the heading.
scripts/docs-check.py checks the links, the frontmatter and a short list of words.
Words
- luxe in prose,
luxefor the command. Never all caps. - Model, not "AI". Coding agent, not "platform" or "solution".
- American spelling.
scripts/voice-check.pychecks it, comments included.
Before you ship it
Read it out loud. If another tool could put its name on the sentence, make it specific. If it sounds like an ad, cut it.