Commands

Commands#

This page documents all available slash commands in gptme. Commands are entered by typing a forward slash (/) followed by the command name.

For CLI arguments and options, see the CLI Reference reference.

Overview#

gptme provides two types of commands:

  1. Built-in commands - Core commands always available

  2. Tool commands - Commands registered by enabled tools

To see available commands in your session, use /help.

Note

Some commands are only available when their corresponding tool is enabled. Use /tools to see which tools are currently active.

Built-in Commands#

Conversation Management#

/log#

Show the conversation log.

/log           # Show visible messages
/log --hidden  # Include hidden system messages

/edit#

Edit the conversation in your default editor.

Opens the conversation as TOML in $EDITOR, allowing you to modify, delete, or reorder messages. After saving and closing, the edited conversation is loaded.

/edit

/undo#

Undo the last action(s).

/undo      # Undo last message
/undo 3    # Undo last 3 messages

/rename#

Rename the conversation.

/rename new-name    # Rename to specific name
/rename             # Interactive mode, enter empty for auto-generate
/rename auto        # Auto-generate name using LLM

/fork#

Create a copy of the current conversation with a new name.

/fork my-experiment

/delete#

Delete a conversation by ID.

Alias: /rm

/delete              # List recent conversations with IDs
/delete abc123       # Delete conversation with ID abc123
/delete --force xyz  # Delete without confirmation

Note

Cannot delete the currently active conversation. Start a new conversation first.

/summarize#

Generate an LLM-powered summary of the conversation.

/summarize

/replay#

Replay tool operations from the conversation.

Useful for:

  • Re-executing code blocks after making manual changes

  • Restoring state (like todo lists) when resuming a conversation

  • Debugging tool behavior

/replay              # Interactive: choose last, all, or tool name
/replay last         # Replay only the last assistant message with tool uses
/replay all          # Replay all assistant messages
/replay todowrite    # Replay all operations for a specific tool

/export#

Export the conversation as an HTML file.

/export                   # Export to <conversation-name>.html
/export my-chat.html      # Export to specific filename

Model & Token Management#

/model#

List available models or switch to a different model.

Alias: /models

/model                    # Show current model info and list available
/model openai/gpt-4o      # Switch to specific model
/model anthropic          # Switch to provider's default model

The model change is persisted to the conversation’s config file.

/tokens#

Show token usage and cost information.

Alias: /cost

Displays:

  • Session costs (current session usage)

  • Conversation costs (all messages)

  • Breakdown by input/output tokens

/tokens

/context#

Show detailed context token usage breakdown.

Displays token counts by:

  • Role (system, user, assistant)

  • Content type (messages, tool uses, thinking blocks)

/context

Tools & Information#

/tools#

List all available tools with their descriptions and token usage.

/tools

/help#

Show the help message with available commands and keyboard shortcuts.

/help

Session Control#

/exit#

Exit gptme, saving the conversation.

/exit

/restart#

Restart the gptme process.

Useful for:

  • Applying configuration changes

  • Reloading tools after code modifications

  • Recovering from state issues

/restart

/clear#

Clear the terminal screen.

Alias: /cls

/clear

Advanced#

/impersonate#

Add a message as if it came from the assistant.

Useful for guiding the conversation or testing tool behavior.

/impersonate I'll help you with that task.
/impersonate          # Interactive mode: enter text at prompt

/setup#

Run the gptme setup wizard.

Configures:

  • Shell completions (bash, zsh, fish)

  • Configuration file

  • Project-specific settings

/setup

/plugin#

Manage gptme plugins.

/plugin list           # List discovered plugins
/plugin info <name>    # Show details about a plugin

Tool Commands#

These commands are provided by tools and are only available when the tool is enabled.

/commit (autocommit)#

Ask the assistant to review staged changes and create a git commit.

The assistant will:

  1. Check git status and git diff --staged

  2. Propose a commit message following Conventional Commits

  3. Create the commit (with confirmation)

/commit

Note

Enable auto-commit on every message by setting GPTME_AUTOCOMMIT=true.

/compact (autocompact)#

Manually trigger conversation compaction to reduce context size.

/compact           # Auto-compact using summarization
/compact auto      # Same as above
/compact resume    # Generate an LLM-powered resume/summary

Note

Auto-compaction happens automatically when tool outputs exceed size thresholds.

/lesson (lessons)#

Manage the lessons system for contextual guidance.

/lesson                    # Show help
/lesson list               # List all lessons
/lesson list tools         # List lessons in a category
/lesson search <query>     # Search lessons by keyword
/lesson show <name>        # Show a specific lesson
/lesson refresh            # Refresh lessons from disk

For more on lessons, see Lessons.

/pre-commit (precommit)#

Manually run pre-commit checks on the repository.

/pre-commit

Note

Pre-commit checks run automatically after file modifications when a .pre-commit-config.yaml exists. Control with GPTME_CHECK=true/false.

/mcp (mcp)#

Manage Model Context Protocol (MCP) servers.

/mcp search <query>        # Search for MCP servers
/mcp info <name>           # Show info about a server
/mcp list                  # List loaded servers
/mcp load <name>           # Load/start an MCP server
/mcp unload <name>         # Unload/stop an MCP server

For more on MCP, see MCP.

Tool Shortcuts#

You can execute tool code directly using slash commands with the tool’s language tag:

/sh echo hello             # Execute shell command
/shell ls -la              # Same as above
/python print("hello")     # Execute Python code
/ipython 2 + 2             # Same as above

This is equivalent to writing a code block:

```shell
echo hello
```

Keyboard Shortcuts#

These shortcuts work in the interactive prompt:

Shortcut

Description

Ctrl+X Ctrl+E

Edit the current prompt in your editor ($EDITOR)

Ctrl+J

Insert a newline without executing (for multi-line input)

Ctrl+C

Cancel current input or interrupt running operation

Ctrl+D

Exit gptme (same as /exit)

Tab

Auto-complete commands, paths, and filenames

Up/Down

Navigate command history

Command Registration#

Tools can register custom commands using the commands parameter in ToolSpec:

from gptme.tools import ToolSpec
from gptme.commands import CommandContext

def my_command(ctx: CommandContext):
    ctx.manager.undo(1, quiet=True)  # Remove the command from log
    print(f"Arguments: {ctx.args}")
    # Optionally yield Message objects

tool = ToolSpec(
    name="mytool",
    desc="My custom tool",
    commands={
        "mycommand": my_command,
    },
)

See Custom Tools for more on creating tools with commands.