> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List GitHub issues

> List a filtered page of issues and pull requests in one repository.

`listGitHubIssues` lists GitHub issues and pull requests together, matching GitHub's repository Issues API.

```ts automations/list-github-issues.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listGitHubIssues } from "automate.ax/github"

export default automation("List open GitHub issues", () => {
  onHttpRequest({ scope: "automation" })
  listGitHubIssues({
    owner: "SentsCo",
    repository: "automate.ax",
    labels: ["bug"],
  })
})
```

`owner` and `repository` are required. Optional filters are `assignee` (login, `"none"`, or `"*"`), `creator`, `direction` (`"asc"` or `"desc"`), `labels`, and `state` (`"open"`, `"closed"`, or `"all"`; default `"open"`). `page` defaults to 1 and `perPage` defaults to 30 with a maximum of 100. Optional `account` defaults to the project binding. Inputs accept compatible signals.

Returns a typed GitHub issue array. Results representing pull requests contain a `pull_request` marker. Request another page while the returned page length equals `perPage`.