Function●Since v0.0

list_threads_command

CLI handler for deepagents threads list.

Fetches and displays a table of recent conversation threads, optionally filtered by agent name or git branch.

list_threads_command(
  agent_name: str | None = None,
  limit: int | None = None,
  sort_by: str | None = None,
  branch: str | None = None,
  verbose: bool = False,
  relative: bool | None = None,
  *,
  output_format: OutputFormat = 'text'
) -> None

Parameters

Name	Type	Description
`agent_name`	`str \| None`	Default:`None` Only show threads belonging to this agent. When `None`, threads for all agents are shown.
`limit`	`int \| None`	Default:`None` Maximum number of threads to display. When `None`, reads from `DA_CLI_RECENT_THREADS` or falls back to the default.
`sort_by`	`str \| None`	Default:`None` Sort field — `"updated"` or `"created"`. When `None`, reads from config (`~/.deepagents/config.toml`).
`branch`	`str \| None`	Default:`None` Only show threads from this git branch.
`verbose`	`bool`	Default:`False` When `True`, show all columns (branch, created, prompt).
`relative`	`bool \| None`	Default:`None` Show timestamps as relative time (e.g., '5m ago'). When `None`, reads from config (`~/.deepagents/config.toml`).
`output_format`	`OutputFormat`	Default:`'text'` Output format — `'text'` (Rich) or `'json'`.

View source on GitHub

list_threads_command

Parameters

LangChain Assistant

Menu

list_threads_command

Parameters