Skip to main content
xbot
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
Edit page

CLI Reference

Complete reference for the xbot CLI terminal interface.

Keyboard shortcuts

Global

ShortcutAction
Ctrl+KOpen command palette (fuzzy search all commands)
Ctrl+CCancel current generation / interrupt
Ctrl+NCycle through available models
Ctrl+PSwitch LLM subscription
Ctrl+LSwitch model (per-session, persists)
Ctrl+TToggle SubAgent progress panel

Input

ShortcutAction
EnterSend message
Shift+EnterNew line
/ Navigate input history
TabAutocomplete
ShortcutAction
/Start typing a slash command
EscClose palette / cancel action
Mouse clickClick sidebar to switch sessions, scroll messages, click settings

Slash commands

Type / in the input box to see all commands. Here’s the complete list:

Setup & Config

CommandDescription
/setupOpen the Setup wizard (LLM, sandbox, theme)
/settingsOpen settings panels (appearance, sessions, LLM, etc.)
/configView/edit config (alias for settings)
/contextShow current token usage and context bar
/usageShow token usage details

Sessions

CommandDescription
/newStart a new session
/sessionsList and switch sessions
/suSwitch session (quick)
/chatChat management
/ssSession status
/rewindRewind to a previous message in the conversation

Conversation

CommandDescription
/clearClear the conversation history
/compressManually compress the context
/cancelCancel the current generation
/searchSearch message history

System

CommandDescription
/helpShow all available commands
/commandsList all commands
/versionShow version information
/updateCheck for and install updates
/debugToggle debug mode
/tasksView background tasks
/channelOpen channel configuration panel
/pluginManage plugins
/paletteOpen command palette
/userUser management

Session lifecycle

CommandDescription
/exitExit xbot-cli
/quitQuit xbot-cli (alias)

Mouse support

The TUI supports full mouse interaction:

  • Sidebar: click any session to switch, scroll to see all sessions
  • Messages: scroll to navigate conversation history
  • Settings: click settings items, use dropdowns, toggle switches
  • Palette: click results to select
  • Progress panel: click to expand/collapse sub-agent details

Themes

Switch themes via Ctrl+K → Theme or /palette theme. xbot includes 9 built-in themes and supports custom themes (JSON files in ~/.xbot/themes/).

Tip
The agent can change themes for you — just ask “switch to dark theme” and it uses the tui_control tool.

Model tiers

xbot uses three model tiers for different complexity levels. Configure via /settings:

TierUse case
VanguardStrongest reasoning — complex tasks, architecture decisions
BalanceBalanced — general-purpose work
SwiftFast/small — quick lookups, simple operations

SubAgents automatically select the appropriate tier. Unconfigured tiers fall back: vanguard → balance → swift.

See also