Niluxv1.0.33
/tools

CLI reference.

Most of the time you only type nilux and talk to it. This page lists everything else.

Terminal commands

bash
# Start a session in the current folder
$nilux
# Show the installed version
$nilux --version
# Install the latest version
$nilux update
# Check your setup and print a report
$nilux doctor
# Manage MCP servers
$nilux mcp add | remove | list | get
# List the Nilux sessions running on this computer
$nilux sessions
# Give a running session a task
$nilux send my-app "run the tests and fix what fails"

nilux mcp is explained in MCP servers; nilux sessions and nilux send in Talking to other sessions.

Slash commands

Type / at the prompt to see the list, then keep typing to filter it. Tab completes the highlighted command.

Conversation

  • /resume: continue an earlier conversation.
  • /rewind: go back to an earlier message, and undo the changes made after it.
  • /clear: start a new conversation.
  • /compact: shorten the conversation so you can keep going. Add instructions after it: /compact keep the API details.
  • /context: see what fills the conversation's context.

Settings

  • /model: switch the model.
  • /effort: how deeply the model thinks: low, high or max.
  • /mode: how much Nilux asks before acting. /mode auto, /mode plan, /mode accept or /mode default switch directly.
  • /config: all other settings.
  • /agents: set up helper agents and the model each one uses.

Project

  • /init: write a nilux.md describing the project.
  • /add-dir: let Nilux work in a folder outside the project.
  • /trust: list the folders you trust, or remove one.
  • /skills: list your skills.
  • /mcp: see your MCP servers, connect, reconnect or switch them off.
  • /plugins: install error checking or the browser plugin.
  • /hooks: see which hooks are loaded.
  • /paste: paste an image or text from the clipboard.
  • /memory: what Nilux keeps about this project and where; /memory on, /memory off and /memory folder control it. See Project memory.

Workflows

  • /workflow <task>: ask for a team of agents to do a large task.
  • /workflow: open the board of the current run.
  • /workflow list, /workflow stop, /workflow resume, /workflow config: see Workflows.

Account and help

  • /balance: your balance and how full the context is.
  • /doctor: check your setup.
  • /logout: sign out and quit.
  • /help: the list of commands.

Your own skills appear in the list as commands too.

Keyboard shortcuts

While Nilux works

  • Esc: stop the current task. Messages you queued come back to the prompt.
  • Ctrl+B: move the running command or helper agents to the background.
  • Ctrl+O: show or hide the details of each step.
  • Ctrl+T: show or hide the todo list.

At the prompt

  • Enter: send.
  • Shift+Enter or Alt+Enter: new line.
  • ↑ and ↓: earlier messages you sent.
  • Esc twice: clear what you typed. On an empty prompt it opens /rewind.
  • Shift+Tab: switch the permission mode.
  • Ctrl+V, Alt+V: paste an image from the clipboard.
  • Ctrl+C twice: quit.

Helper agents

  • ↓ on an empty prompt, or Alt+A: open the list of agents.
  • Enter: open the selected agent; Esc: go back.
  • Ctrl+X: stop the selected agent.
TIP

On a Mac, Alt is the Option key. If Alt shortcuts do nothing, set your terminal to use Option as Meta. In Terminal.app the setting is Use Option as Meta key (Settings → Profiles → Keyboard); in iTerm2 it is Left Option key: Esc+.

← Previous · PluginsNext · Subagents →