Skip to content
Judgment Labs
Esc
navigateopen⌘Jpreview
On this page

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.

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.

Was this page helpful?