Charm Docs

Appearance

Sessions ​

Crush is session-based. Each session preserves its own conversation history and context. You can maintain multiple sessions per project and switch between them at any time.

Switching Sessions in the TUI ​

Press ctrl+p to open the command palette, then search for the session you want to switch to. Your conversation history and context are preserved across switches.

Session Management via CLI ​

Crush provides a full session management CLI:

List Sessions ​

bash
crush session list
# or
crush session ls

Use --json for machine-readable output.

Show a Session ​

bash
crush session show <id>

Displays details about a specific session.

Show the Most Recent Session ​

bash
crush session last

Continue a Session ​

When starting Crush, you can resume a previous session:

bash
# Continue a specific session
crush --session <id>
crush -s <id>

# Continue the most recent session
crush --continue
crush -C

This also works with crush run:

bash
crush run -s <id> "your prompt here"
crush run -C "your prompt here"

Rename a Session ​

bash
crush session rename <id> "new title"

Delete a Session ​

bash
crush session delete <id>
crush session rm <id>