list-threads

List threads for a repo with sorting, filtering, and full-text search

Auth

Authenticated Owner Scope

Examples

pearing-cli list-threads website
pearing-cli list-threads teams/platform/website --sort=-activity
pearing-cli list-threads website --sort=created
pearing-cli list-threads website \
  --status open \
  --status draft \
  --kind task \
  --priority now
pearing-cli list-threads website --search "auth token" --status open

Expected Response

Prints a paginated JSON response from the API.

Errors

  • 404 Not Found when the referenced resource does not exist.
  • 403 Forbidden when owner/repo access checks fail.

Common auth errors are documented on the CLI overview page.

Help Output

List threads for a repo.

Usage: pearing-cli list-threads [OPTIONS] <REPO>

Arguments:
  <REPO>  Repo locator (`teams/<team_slug>/<repo_slug>` or `<username>/<repo_slug>`), or `<repo_slug>` for authenticated user

Options:
      --page <PAGE>          Page number (1-based)
      --per-page <PER_PAGE>  Results per page
      --sort <SORT>          Sort by one of: activity, -activity, created, -created
      --status <STATUS>      Filter by thread status. Repeat to keep multiple statuses [possible values: open, draft, closed, done]
      --priority <PRIORITY>  Filter by thread priority. Repeat to keep multiple priorities [possible values: now, later]
      --kind <KIND>          Filter by thread kind. Repeat to keep multiple kinds [possible values: discussion, change, task]
      --size <SIZE>          Filter by thread size. Repeat to keep multiple sizes [possible values: small, large]
      --search <SEARCH>      Full-text search across thread titles, bodies, and reply bodies
  -h, --help                 Print help