Commands and keys

Command Palette and slash commands

Every command is in two places:

• Command Palette (ctrl+k) opens over whatever you are doing, anywhere, with your draft left where it was.
• Slash commands: type / at the start of an empty composer and the same commands open above it.

Both list only what can run where you are, with the five you used last at the top. Type to filter by name, slash command or a few words each is known by: exit finds Quit. A pane beside the list says what the command does and the arguments it takes.

enter runs a command. In the slash list, tab puts it in the composer so you can add arguments: /diff pr 142, /dock left, /compact the API decisions.

Past the command, the list shows the arguments it takes, such as /diff turn or /diff pr <number or URL>, and narrows as you type. tab fills in the one under the cursor. enter runs it when nothing is missing, and fills it in when it still needs a value. esc puts the list away for that command. In the composer, a command Luxe knows is highlighted, and so are the words of it you have typed, like pr in /diff pr 142. A command that stays plain is misspelled.

Slash commands

The Command Palette also lists commands with no slash form, such as Copy message, Swap the sidebar’s side and, in a review, Send comments.

Help

Help (/help) shows every key for the screen you are on, grouped and drawn from your own bindings. In Guided Review it shows the review’s keys. Help has no default key, because the obvious ones do not reach a terminal program reliably. To give it one:

{ "tui.app.toggle_help": ["f1"] }

Default keys

The name in the last column is what keybindings.json uses.

Compose

enter and alt+enter are fixed. ctrl+enter also sends, as tui.editor.submit.

Read

Conversation

An edit replaces your last message and the answer to it, and Replace the last answer drops the old answer, so the model sees only the new version. Ask again sends your last message once more, after the answer if there was one. The replaced messages stay in the session file but leave the conversation. All three wait for a running turn to finish.

Workspace

Guided Review

Rebind keys

Put your bindings in ~/.config/luxe/keybindings.json, or open it from Configuration with Edit configuration files. Each entry is a name from the tables above and a list of keys:

{
  "tui.app.open_palette": ["ctrl+p"],
  "tui.preview.toggle": ["alt+p"],
  "tui.app.toggle_help": ["f1"]
}

• A binding replaces that action’s default keys rather than adding to them.
• A key you bind is taken from any action that had it by default.
• A key is modifiers and one key joined by +: ctrl, shift, alt, then a letter, a digit, enter, esc, tab, space, backspace, delete, insert, an arrow (up, down, left, right), home, end, pageup, pagedown, or f1 to f12.
• An unknown name or key is skipped with a warning in the log, and the rest still load. An action whose keys are all invalid is left with none, rather than its defaults.
• A project’s .luxe/keybindings.json applies over yours.

/reload or ctrl+shift+r applies a change without restarting.

Alt keys on a Mac

A Mac has no Alt key. Its Option key types characters instead: option+o is ø, option+p is π. Most of Luxe’s alt keys need your terminal to send Option as Alt:

Ghostty already does this on the “U.S.” keyboard layouts. On the others it sends the character and marks it as an Alt key. On “ABC”, the Mac’s default English layout, Luxe reads that back as the key you pressed, so option+o opens a file from the preview without any setting. On other layouts, set the option above.