issue_list read

List issues, newest-updated first; filters combine with AND, 50 by default and 200 at most, and while has_more is true pass next_cursor back as cursor. The cursor knows which way it points, so the same argument pages backwards with prev_cursor. To find every document of one kind, pass its type key as type; roadmap://types lists the keys, and a key never changes. stale set finds the issues holding a stale link of their own: the review inbox. Nothing filters on overdue, so read it from the rows you already have. Soft-deleted issues are excluded.

Arguments

Name	Type	Description
`assignee_id`	null \| string	restrict to one assignee, by ULID
`cursor`	string	the next_cursor or prev_cursor from a previous call. The cursor knows which way it points, so one argument pages both ways
`include_total`	boolean	also return total, the number of issues matching these filters across every page; costs one count on any page but a first one that holds everything
`label`	null \| string	restrict to issues carrying one label, by name or ULID; read roadmap://labels or call label_list for the ones that exist
`limit`	integer	how many to return; 50 by default and 200 at most
`milestone_id`	null \| string	restrict to one milestone, by ULID; or the literal none for issues in no milestone
`project`	null \| string	restrict to one project, by key or ULID
`stale`	boolean	only issues with at least one stale link of their own, in links_out: a link whose target's description changed, or whose target was superseded, since the link was confirmed. A stale link into an issue does not count. The review inbox
`status`	null \| string	the issue's workflow state, one of: backlog, todo, in_progress, in_review, done, canceled. done and canceled are both terminal One of `backlog`, `todo`, `in_progress`, `in_review`, `done`, `canceled`.
`type`	null \| string	restrict to issues of one type, by key such as spec; read roadmap://types for the keys. This is how to find every document of one kind

Input schema

Exactly what tools/list serves.

input schema
{
  "additionalproperties": false,
  "properties": {
    "assignee_id": {
      "description": "restrict to one assignee, by ULID",
      "type": [
        "null",
        "string"
      ]
    },
    "cursor": {
      "description": "the next_cursor or prev_cursor from a previous call. The cursor knows which way it points, so one argument pages both ways",
      "type": "string"
    },
    "include_total": {
      "description": "also return total, the number of issues matching these filters across every page; costs one count on any page but a first one that holds everything",
      "type": "boolean"
    },
    "label": {
      "description": "restrict to issues carrying one label, by name or ULID; read roadmap://labels or call label_list for the ones that exist",
      "type": [
        "null",
        "string"
      ]
    },
    "limit": {
      "description": "how many to return; 50 by default and 200 at most",
      "type": "integer"
    },
    "milestone_id": {
      "description": "restrict to one milestone, by ULID; or the literal none for issues in no milestone",
      "type": [
        "null",
        "string"
      ]
    },
    "project": {
      "description": "restrict to one project, by key or ULID",
      "type": [
        "null",
        "string"
      ]
    },
    "stale": {
      "description": "only issues with at least one stale link of their own, in links_out: a link whose target's description changed, or whose target was superseded, since the link was confirmed. A stale link into an issue does not count. The review inbox",
      "type": "boolean"
    },
    "status": {
      "description": "the issue's workflow state, one of: backlog, todo, in_progress, in_review, done, canceled. done and canceled are both terminal",
      "enum": [
        "backlog",
        "todo",
        "in_progress",
        "in_review",
        "done",
        "canceled"
      ],
      "type": [
        "null",
        "string"
      ]
    },
    "type": {
      "description": "restrict to issues of one type, by key such as spec; read roadmap://types for the keys. This is how to find every document of one kind",
      "type": [
        "null",
        "string"
      ]
    }
  },
  "type": "object"
}