CLI command
tinbox threads
List thread summaries (or, with --changed-since, the freshness probe)
Usage
sh
tinbox threads --inbox <inbox> [--unread] [--mine] [--unanswered] --state <state> --limit <limit> --changed-since <changed-since>Flags
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
--inbox | string | yes | — | scope to an inbox |
--unread | boolean | no | — | only threads with unread messages |
--mine | boolean | no | — | only threads assigned to me |
--unanswered | boolean | no | — | only open, unassigned threads (composes unassigned + state=open) |
--state | string | yes | — | shared-inbox workflow state: open | closed |
--limit | string | yes | — | max threads (1–100; probe mode: 1–500) |
--changed-since | string | yes | — | freshness probe (PRD §8.3): minimal {id, inboxId, lastMessageAt, updatedAt, state, status} stamps for threads changed after <ts> (ISO-8601 or epoch-ms). Probe before acting on stale context; use the returned `now` as your next watermark. |