sessions
Search and list indexed agent sessions. Local, no SSH, no agents-cli boot.
Arguments
| Argument | Description | Choices | Default |
|---|
[query...] | FTS query, or a session id — or use search / list / view | | |
Options
| Flags | Description | Choices | Default |
|---|
-v | output the version number | | |
--json | JSON array of SessionMeta-shaped rows | | |
-n, --limit <n> | max rows | | 20 |
-a, --agent <id> | filter by harness (claude, grok, …). claude@2.1.263 also sets --version | | |
--agents <id> | alias of --agent | | |
--version <ver> | filter by harness version (e.g. 2.1.263, 0.2.82) | | |
-p, --project <name> | filter by project name | | |
--account <label> | filter by account email, org name, or label substring | | |
--email <email> | filter by account or actor email | | |
--local | local index only (always true in v1; accepted for agents-cli flag parity) | | |
--no-interactive | ignored; this CLI never opens a picker | | |
-h, --help | display help for command | | |
Examples
sessions search "auth middleware" --json --limit 5
sessions list --agent grok
sessions view a1b2c3d4 --json
sessions list --email ada@example.com
sessions search --account work login
Notes
Bare `sessions [query]` still works (search / list / id lookup). Prefer the
named verbs in scripts. resume/stop/inject stay on `agents sessions <verb>`.
Hidden fast paths (no commander): __query __serve
sessions list
List recent indexed sessions
Options
| Flags | Description | Choices | Default |
|---|
--json | JSON array of SessionMeta-shaped rows | | |
-n, --limit <n> | max rows | | 20 |
-a, --agent <id> | filter by harness (claude, grok, …). claude@2.1.263 also sets --version | | |
--agents <id> | alias of --agent | | |
--version <ver> | filter by harness version (e.g. 2.1.263, 0.2.82) | | |
-p, --project <name> | filter by project name | | |
--account <label> | filter by account email, org name, or label substring | | |
--email <email> | filter by account or actor email | | |
--local | local index only (always true in v1; accepted for agents-cli flag parity) | | |
--no-interactive | ignored; this CLI never opens a picker | | |
-h, --help | display help for command | | |
Examples
sessions list --limit 20
sessions list --agent claude --json
sessions list --agent claude --version 2.1.263
sessions list --account work
sessions list --email ada@example.com -n 5
sessions search [query...]
Full-text search the session index
Arguments
| Argument | Description | Choices | Default |
|---|
[query...] | FTS query (topic, path, transcript text) | | |
Options
| Flags | Description | Choices | Default |
|---|
--json | JSON array of SessionMeta-shaped rows | | |
-n, --limit <n> | max rows | | 20 |
-a, --agent <id> | filter by harness (claude, grok, …). claude@2.1.263 also sets --version | | |
--agents <id> | alias of --agent | | |
--version <ver> | filter by harness version (e.g. 2.1.263, 0.2.82) | | |
-p, --project <name> | filter by project name | | |
--account <label> | filter by account email, org name, or label substring | | |
--email <email> | filter by account or actor email | | |
--local | local index only (always true in v1; accepted for agents-cli flag parity) | | |
--no-interactive | ignored; this CLI never opens a picker | | |
-h, --help | display help for command | | |
Examples
sessions search "auth middleware" --json --limit 5
sessions search --agent grok auth
sessions search --agent claude --version 2.1.263 login
sessions search --email ada@example.com auth
sessions search --account work --project agents-cli
sessions view <id>
Show one session by id or short id
Arguments
| Argument | Description | Choices | Default |
|---|
<id> | full session id or 8-character short id | | |
Options
| Flags | Description | Choices | Default |
|---|
--json | JSON array of SessionMeta-shaped rows | | |
-n, --limit <n> | max rows | | 20 |
-a, --agent <id> | filter by harness (claude, grok, …). claude@2.1.263 also sets --version | | |
--agents <id> | alias of --agent | | |
--version <ver> | filter by harness version (e.g. 2.1.263, 0.2.82) | | |
-p, --project <name> | filter by project name | | |
--account <label> | filter by account email, org name, or label substring | | |
--email <email> | filter by account or actor email | | |
--local | local index only (always true in v1; accepted for agents-cli flag parity) | | |
--no-interactive | ignored; this CLI never opens a picker | | |
-h, --help | display help for command | | |
Examples
sessions view a1b2c3d4 --json
sessions view a1b2c3d4 --agent grok
No command matches that search.
