Files
luxe/docs/brand/voice.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

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, so G is 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, luxe for the command. Never all caps.
  • Model, not "AI". Coding agent, not "platform" or "solution".
  • American spelling. scripts/voice-check.py checks 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.