judgment 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 [OPTIONS] [[[ORG_ID] PROJECT_ID] SESSION_ID...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] SESSION_ID | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
-o, --output | yaml, json | no | Output format. |
sessions search
Search sessions.
Filter, sort, time-bound, and paginate sessions in a project.
judgment sessions search [OPTIONS] [[[ORG_ID] PROJECT_ID]...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
--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"}. |
-o, --output | table, yaml, json | no | Output format. |
sessions trace-behaviors
List behaviors observed across a session’s traces.
judgment sessions trace-behaviors [OPTIONS] [[[ORG_ID] PROJECT_ID] SESSION_ID...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] SESSION_ID | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
-o, --output | yaml, json | no | Output format. |
sessions trace-ids
List trace IDs in a session.
judgment sessions trace-ids [OPTIONS] [[[ORG_ID] PROJECT_ID] SESSION_ID...]Arguments
| Name | Required |
|---|---|
[[ORG_ID] PROJECT_ID] SESSION_ID | no |
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--organization-id, --org-id | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
--organization, --org | text | no | Organization name to resolve. |
--project-id | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
--project | text | no | Project name to resolve. |
-o, --output | yaml, json | no | Output format. |