Commands Reference

All commands start with / and can be tab-completed.

/help

Show the list of available commands.

/help

/new

Start a new session. Resets all messages, token counts, input history, checkpoints, and the redo stack. If you were in a git repo, old checkpoint refs are cleaned up.

/new

/sessions

List up to 10 recent sessions for the current working directory. Each entry shows the session ID prefix (8 characters), title, time since last update, and message count.

/sessions

Example output:

  a1b2c3d4  Fix login bug                2h ago  12 messages
  e5f6g7h8  Refactor auth module         1d ago  34 messages

/continue

Resume a previous session by its ID prefix. Loads all messages back into the conversation and restores token counts.

/continue <id-prefix>

No argument: behaves the same as /sessions (lists recent sessions).
With argument: finds a session whose ID starts with the given prefix and resumes it. If no match is found, prints an error.

/branch

Fork the conversation at the current point. Creates a new session that branches from the current message, letting you explore an alternative direction without losing the original conversation.

/branch

TUI only.
The new branch becomes the active session.

/rename

Rename the current session.

/rename <new title>

TUI only.
Updates the session title shown in /sessions output.

/resume

Alias for /continue. Identical behavior.

/resume <id-prefix>

/config

Manage preferences and configuration. See also Configuration for full details.

/config show

Display all preference keys, their current values, and defaults.

/config show

/config models

Show available models and pricing.

/config models

/config tools

Show available agent tools.

/config tools

/config messaging

Show messaging/Telegram configuration.

/config messaging

/config theme

Show theme settings.

/config theme

/config set

Set a preference value.

/config set <key> <value>

Provider keys

Key	Description
`anthropic.api_key`	Anthropic API key
`openai.api_key`	OpenAI API key
`brave.api_key`	Brave Search API key (for web search tool)

Model

Key	Description
`model`	Default model (e.g. `claude-sonnet`, `gpt-4o`, `claude-opus`)

Footer display

Key	Type	Default	Description
`footer.tokens`	bool	`true`	Show token count in footer
`footer.cost`	bool	`true`	Show estimated cost in footer
`footer.cwd`	bool	`true`	Show working directory in footer
`footer.session`	bool	`true`	Show session info in footer
`footer.keybindings`	bool	`true`	Show keybinding hints in footer

Key	Description
`telegram.bot_token`	Telegram bot token
`telegram.allowed_ids`	Comma-separated allowed Telegram user IDs

Boolean values accept: true/false, on/off, yes/no, 1/0 (case-insensitive).

Examples:

/config set anthropic.api_key sk-ant-...
/config set model claude-opus
/config set footer.cost false
/config set openai.api_key sk-...

/config reset

Reset all preferences to their default values.

/config reset

/telegram

Start or stop the Telegram bot adapter. When running, you can interact with your agent from Telegram.

/telegram

TUI only.
Requires telegram.bot_token and telegram.allowed_ids to be configured (see Configuration).

/undo

Undo the last agent turn by restoring the working tree to the checkpoint taken before that turn.

/undo

Requires git (must be inside a git repository).
Cannot undo while the agent is running.
Prints an error if there are no checkpoints to undo.
Multiple /undo commands walk back through the checkpoint stack.

See Undo / Redo for a detailed explanation.

/redo

Re-apply the last undone agent turn.

/redo

Only available after an /undo.
The redo stack is cleared whenever the agent runs a new turn.
Same requirements as /undo (git, not during agent loop).

/clear

Clear the chat display. Resets displayed messages and token counters, but does not end the session. Messages remain persisted in the database.

/clear

/tweet

Post or schedule tweets from the TUI.

/tweet <text>                                    # post immediately
/tweet --schedule <HH:MM|RFC3339> <text>         # schedule
/tweet --schedule <time> --daily <text>          # recurring daily
/tweet --list                                    # list scheduled tweets
/tweet --cancel <id>                             # cancel scheduled tweet

Requires twitter.bearer_token (see Configuration).

/schedule

Manage scheduled tool jobs.

/schedule list                                   # list all jobs
/schedule cancel <id>                            # cancel a job
/schedule add <tool> <HH:MM|RFC3339> <json>      # schedule a tool

/tools

Show and toggle agent tools.

/tools

Opens a picker to enable/disable individual tools. Supports tool profiles: safe, coder (default), research.

/refresh

Reload current session messages from the database.

/refresh

TUI only.

/exit

Quit muxd.

/exit

/quit

Alias for /exit.

/quit