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. |