---
title: "judgment agent-threads"
description: "List and inspect agent thread conversations (global_copilot, custom_agent)."
sidebar:
  label: "Agent-threads"
seo:
  title: "judgment agent-threads CLI Reference | Judgment Docs"
  description: "Command reference for `judgment agent-threads`, used to list and inspect agent thread conversations in Judgment CLI workflows."
---

> **Warning**
>
> **The Judgment CLI is deprecated and no longer under active development.**
> This reference is retained for existing users. See the [CLI deprecation
> notice](/documentation/cli) for supported alternatives.


List and inspect agent thread conversations (global_copilot, custom_agent).

## Commands

| Command | Description |
| ------- | ----------- |
| [`agent-threads get`](#agent-threads-get) | Get an agent thread. |
| [`agent-threads list`](#agent-threads-list) | List agent thread conversations. |

### `agent-threads get`

Get an agent thread.

Get one agent thread conversation, including its transcript, metadata, active run status, and timestamps.

```bash
judgment agent-threads get [OPTIONS] [[[ORG_ID] PROJECT_ID] THREAD_ID...]
```

**Arguments**

| Name | Required |
| ---- | -------- |
| `[[ORG_ID] PROJECT_ID] THREAD_ID` | no |

**Options**

| Flag | Type | Required | Description |
| ---- | ---- | -------- | ----------- |
| <code style={{whiteSpace:"nowrap"}}>--organization-id</code>, <code style={{whiteSpace:"nowrap"}}>--org-id</code> | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
| <code style={{whiteSpace:"nowrap"}}>--organization</code>, <code style={{whiteSpace:"nowrap"}}>--org</code> | text | no | Organization name to resolve. |
| <code style={{whiteSpace:"nowrap"}}>--project-id</code> | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
| <code style={{whiteSpace:"nowrap"}}>--project</code> | text | no | Project name to resolve. |
| <code style={{whiteSpace:"nowrap"}}>-o</code>, <code style={{whiteSpace:"nowrap"}}>--output</code> | `yaml`, `json` | no | Output format. |


### `agent-threads list`

List agent thread conversations.

List the authenticated user's agent thread conversations in a project (global_copilot or custom_agent). Returns each thread's title, type, message count, active run status, and timestamps.

```bash
judgment agent-threads list [OPTIONS] [[[ORG_ID] PROJECT_ID]...]
```

**Arguments**

| Name | Required |
| ---- | -------- |
| `[[ORG_ID] PROJECT_ID]` | no |

**Options**

| Flag | Type | Required | Description |
| ---- | ---- | -------- | ----------- |
| <code style={{whiteSpace:"nowrap"}}>--organization-id</code>, <code style={{whiteSpace:"nowrap"}}>--org-id</code> | text | no | Organization ID. Defaults to JUDGMENT_ORG_ID or saved context. |
| <code style={{whiteSpace:"nowrap"}}>--organization</code>, <code style={{whiteSpace:"nowrap"}}>--org</code> | text | no | Organization name to resolve. |
| <code style={{whiteSpace:"nowrap"}}>--project-id</code> | text | no | Project ID. Defaults to JUDGMENT_PROJECT_ID or saved context. |
| <code style={{whiteSpace:"nowrap"}}>--project</code> | text | no | Project name to resolve. |
| <code style={{whiteSpace:"nowrap"}}>--agent-type</code> | `global_copilot`, `custom_agent` | yes | Active agent thread kinds available for new conversations: `global_copilot` or `custom_agent`. |
| <code style={{whiteSpace:"nowrap"}}>--agent-name</code> | text | yes | — |
| <code style={{whiteSpace:"nowrap"}}>--judge-id</code> | text | no | Restrict to threads associated with this judge. |
| <code style={{whiteSpace:"nowrap"}}>--agent-config-id</code> | text | no | Restrict to threads for this exact agent config. |
| <code style={{whiteSpace:"nowrap"}}>--scope</code> | `owner`, `project` | no | — |
| <code style={{whiteSpace:"nowrap"}}>--owner-user-id</code> | text | no | Restrict project history to a specific thread owner. |
| <code style={{whiteSpace:"nowrap"}}>--all-users</code> | boolean | no | Deprecated alias for scope=project. Prefer the `scope` query parameter. |
| <code style={{whiteSpace:"nowrap"}}>--limit</code> | number | no | Maximum number of threads to return (1–100). |
| <code style={{whiteSpace:"nowrap"}}>--cursor-updated-at</code> | text | no | Pagination cursor: `updated_at` value from a previous `next_cursor`. |
| <code style={{whiteSpace:"nowrap"}}>--cursor-thread-id</code> | text | no | Pagination cursor: `thread_id` value from a previous `next_cursor`. |
| <code style={{whiteSpace:"nowrap"}}>-o</code>, <code style={{whiteSpace:"nowrap"}}>--output</code> | `table`, `yaml`, `json` | no | Output format. |