Charm Docs

Appearance

crush session ​

Manage Crush sessions from the command line.

Subcommands ​

session list ​

List all sessions. This includes sessions across all projects.

bash
crush session list
crush session ls

Use --json for machine-readable output:

bash
crush session ls --json

session show ​

Show details about a specific session.

bash
crush session show <id>

Use --json for machine-readable output.

session last ​

Show the most recent session.

bash
crush session last

Use --json for machine-readable output.

session delete ​

Delete a session permanently.

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

session rename ​

Rename a session.

bash
crush session rename <id> "new title"

Global Flags ​

FlagDescription
--jsonOutput in JSON format
--data-dirCustom Crush data directory

Examples ​

bash
# List sessions and pipe to jq
crush session ls --json | jq '.[] | {id, title}'

# Delete old sessions
crush session ls --json | jq -r '.[] | select(.created_at < "2026-01-01") | .id' | xargs -I {} crush session rm {}

# Find a session by title
crush session ls --json | jq '.[] | select(.title | contains("refactor"))'