gage session

The gage session command manages sessions. For background, see Sessions.

gage session [OPTIONS] <COMMAND>

Commands that take session IDs accept unique ID prefixes. The -A, --agent option, given before the subcommand, operates on agent sessions instead of Claude Code sessions.

session list

List available sessions.

gage session list [OPTIONS]
OptionDescription
-m, --moreShow more items. Repeat to show more per use.
-a, --allShow all items
-n, --limit <LIMIT>Limit the number of items shown (default: 20)
--project <PATH>Filter by project path (repeatable)
--since <SINCE>Filter by how long ago the session was modified (e.g. 1h, 30m, 7d)
--emptyOnly show empty sessions
--full-idShow the full session ID, never truncating it
-S, --statsInclude additional stats columns: model time, tokens (in / out / cached), turns

session view

View a session.

gage session view [OPTIONS] [SESSION]

If you omit the ID, Gage lets you pick from a list.

OptionDescription
-v, --options <OPTIONS>View options (comma-separated)

View options: turns shows model turns in the outline. detail shows all entries. The default hides low-signal entries.

session move

Move a session to a different project directory.

gage session move [OPTIONS] <SESSION> <DIR>

The destination project directory must exist.

OptionDescription
-y, --yesSkip confirmation prompt

session delete

Delete sessions.

gage session delete [OPTIONS] [IDS]...
OptionDescription
--emptyDelete empty sessions
-y, --yesSkip confirmation prompt