Rubix CLI command reference

Complete reference for the Rubix CLI. Top-level commands are what you run from the shell. Slash commands are what you run inside the chat UI.

Top-level commands

rubix

Launch the interactive chat UI. Equivalent to rubix chat with no options.

rubix

rubix chat

Start interactive chat, optionally resuming a session or pre-sending a prompt.

rubix chat [options]

Options

Flag	Description
`-s, --session-id <id>`	Resume an existing session by id. Find ids with `rubix sessions`.
`-p, --prompt <text>`	Send a prompt immediately after launch. Non-interactive when combined with a session-id.

Examples

rubix chat --session-id "abc-123"
rubix chat --prompt "What is the health of production?"

rubix logout

Clear local authentication. The next rubix run prompts for device-code login again.

rubix logout

rubix sessions

List your past chat sessions. Shows id, title, associated agent, and last update time.

rubix sessions

Use the id with rubix chat --session-id <id> to resume.

rubix model

Manage the AI model used for chat.

rubix model [subcommand] [modelId]

Subcommands

Subcommand	Description
`list`	Show available models for your workspace.
`get`	Print the currently selected model.
`set <modelId>`	Switch to a specific model for new sessions.

Available inside the chat UI. Type / to open the menu, or type any command directly.

Command	Purpose
`/login`	Authenticate via device-code flow
`/logout`	Clear local authentication
`/status`	Show authentication, session, and environment status
`/resume`	Resume a previous conversation
`/new`	Start a fresh conversation
`/environments`	Switch the active environment
`/refresh`	Refresh environments and dashboard stats
`/models`	Switch the AI model for this session
`/agents`	Switch the agent (app) binding for new sessions
`/paste`	Insert clipboard content cleanly, bypassing terminal paste truncation
`/send`	Send the last shell output into chat as context
`/clear`	Clear visible conversation history (session is preserved)
`/rename`	Rename the current session
`/console`	Open the web console in your default browser
`/docs`	Open RubixKube docs in your default browser
`/help`	Toggle the keyboard shortcut and help panel
`/exit`	Exit the Rubix CLI
`/quit`	Alias for `/exit`
`/untrust`	Remove the current folder from the trusted list

--version

Print the installed CLI version and exit.

rubix --version

--help

Print help for any command.

rubix --help
rubix chat --help
rubix model --help

RUBIX_API_KEY

Override the stored token for this invocation. Useful for CI or ephemeral runners. When set, the CLI skips the device-code prompt.

RUBIX_ENV_ID

Pin the environment for this invocation. Overrides any session default.

Concrete flows that combine the commands above.

Where credentials live and how folder trust works.