| Name | Type | Description |
|---|---|---|
agent_name | str | None | Default: NoneOnly show threads belonging to this agent. When |
limit | int | None | Default: NoneMaximum number of threads to display. When |
sort_by | str | None | Default: None |
branch | str | None | Default: None |
cwd | str | None | Default: None |
verbose | bool | Default: False |
relative | bool | None | Default: None |
output_format | OutputFormat | Default: 'text' |
CLI handler for deepagents threads list.
Fetches and displays a table of recent conversation threads, optionally filtered by agent name, git branch, or working directory.
Sort field ā "updated" or "created".
When None, reads from config (~/.deepagents/config.toml).
Only show threads from this git branch.
Only show threads whose stored cwd metadata equals this path
(exact string match ā no normalization or prefix matching). When
None, no cwd filter is applied. Threads without a stored cwd
(older rows) are excluded when this is set.
When True, show all columns (branch, created, prompt).
Show timestamps as relative time (e.g., '5m ago').
When None, reads from config (~/.deepagents/config.toml).
Output format ā 'text' (Rich) or 'json'.
