Add a detailed section for /compress in the CLI Commands Reference,
explaining what it does, when to use it, requirements, and output format.
Previously only had a one-line table entry.
Browse past sessions (shows title, preview, last active)
hermes sessions rename <id> <title>
Set or change a session's title
hermes sessions export <id>
Export a session
hermes sessions delete <id>
Delete a specific session
hermes sessions prune
Remove old sessions
hermes sessions stats
Show session statistics
Insights
Command
Description
hermes insights
Show usage analytics for the last 30 days
hermes insights --days 7
Analyze a custom time window
hermes insights --source telegram
Filter by platform
Slash Commands (Inside Chat)
Type / in the interactive CLI to see an autocomplete dropdown.
Navigation & Control
Command
Description
/help
Show available commands
/quit
Exit the CLI (aliases: /exit, /q)
/clear
Clear screen and reset conversation
/new
Start a new conversation
/reset
Reset conversation only (keep screen)
Tools & Configuration
Command
Description
/tools
List all available tools
/toolsets
List available toolsets
/model [provider:model]
Show or change the current model (supports provider:model syntax to switch providers)
/provider
Show available providers with auth status
/config
Show current configuration
/prompt [text]
View/set custom system prompt
/personality [name]
Set a predefined personality
Conversation
Command
Description
/history
Show conversation history
/retry
Retry the last message
/undo
Remove the last user/assistant exchange
/save
Save the current conversation
/compress
Manually compress conversation context
/title [name]
Set or show the current session's title
/usage
Show token usage for this session
/insights [--days N]
Show usage insights and analytics (last 30 days)
/compress
Manually triggers context compression on the current conversation. This summarizes middle turns of the conversation while preserving the first 3 and last 4 turns, significantly reducing token count. Useful when:
The conversation is getting long and you want to reduce costs
You're approaching the model's context limit
You want to continue the conversation without starting fresh
Requirements: at least 4 messages in the conversation. The configured model (or compression.summary_model from config) is used to generate the summary. After compression, the session continues seamlessly with the compressed history.
Reports the result as: Compressed: X → Y messages, ~N → ~M tokens.
:::tip
Compression also happens automatically when approaching context limits (configurable via compression.threshold in config.yaml). Use /compress when you want to trigger it early.
:::
Clear input/images, interrupt agent, or exit (contextual)
Ctrl+D
Exit
Tab
Autocomplete slash commands
:::tip
Commands are case-insensitive — /HELP works the same as /help.
:::
:::info Image paste keybindings
Alt+V works in most terminals but not in VSCode's integrated terminal (VSCode intercepts Alt+key combos). Ctrl+V only triggers an image check when the clipboard also contains text (terminals don't send paste events for image-only clipboard). The /paste command is the universal fallback. See the full compatibility table.
:::
b3ea7714f5