Sessions
Search and inspect sessions in a project.
Search and inspect sessions in a project.
Commands
| Command | Description |
|---|---|
sessions get | Get session detail. |
sessions search | Search sessions. |
sessions trace-behaviors | List behaviors observed across a session’s traces. |
sessions trace-ids | List trace IDs in a session. |
sessions get
Get session detail.
judgment sessions get <PROJECT_ID> <SESSION_ID>Arguments
| Name | Required |
|---|---|
PROJECT_ID | yes |
SESSION_ID | yes |
sessions search
Search sessions.
Filter, sort, time-bound, and paginate sessions in a project.
judgment sessions search [OPTIONS] <PROJECT_ID>Arguments
| Name | Required |
|---|---|
PROJECT_ID | yes |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--filters | text | yes | Filter expressions, ANDed together. Each item is {"field":<field>,"op":<op>,"value":<value>}. Allowed ops depend on the field's type. Op groups: - STRING_OPS = = | != | contains | does_not_contain - NUMERIC_OPS = = | != | < | <= | > | >= - ARRAY_ANY = any (matches when the row's array overlaps the supplied values) String fields (op in STRING_OPS, value is a string): session_id. Numeric fields (op in NUMERIC_OPS, value is a number): trace_count, latency (nanoseconds), total_cost (USD). Array fields (op = any, value is an array): behaviors (behavior UUIDs). |
--time-range | text | no | {"start_time":<iso8601-string>|null,"end_time":<iso8601-string>|null}. Either bound may be null to leave that side open. Invalid timestamps return 400. |
--pagination | text | yes | {"limit":<int 1-200>,"cursorSortValue":<string>|null,"cursorItemId":<string>|null}. First page: pass null for both cursor fields. Each response returns nextCursor:{sort_value,session_id} (or null when hasMore=false); copy those into cursorSortValue and cursorItemId for the next page. |
--sort-by | text | no | {"field":<sort_field>,"direction":"asc"|"desc"} where sort_field is one of: created_at, num_traces, latency, llm_cost. Default when omitted: {"field":"created_at","direction":"desc"}. |
sessions trace-behaviors
List behaviors observed across a session’s traces.
judgment sessions trace-behaviors <PROJECT_ID> <SESSION_ID>Arguments
| Name | Required |
|---|---|
PROJECT_ID | yes |
SESSION_ID | yes |
sessions trace-ids
List trace IDs in a session.
judgment sessions trace-ids <PROJECT_ID> <SESSION_ID>Arguments
| Name | Required |
|---|---|
PROJECT_ID | yes |
SESSION_ID | yes |