# komrad pr list

List a repository's pull requests, or those opened from one branch

[komrad pr](https://komrad.dev/latest/cli/pr.md)

```bash
komrad pr list <remote-url> [branch]
```

List a repository's pull requests through the forge its host is connected to.

Give a remote as git spells it. With a branch, every pull request opened from it is listed whatever its state; without one, the repository's open pull requests are listed.

```
komrad pr list git@github.com:harrisoncramer/komrad.git
komrad pr list git@github.com:harrisoncramer/komrad.git agent/some-branch
```

The forge hands them over a hundred at a time and this follows every page, so the list is whole; to read one page at a time, call the endpoint through komrad rpc with a limit and the cursor it answers.

A repository the credential cannot see answers not found, which is how a token without access to a private repository shows up.

## Inherited flags

| Flag | Type | Description |
| --- | --- | --- |
| [`--config`](https://komrad.dev/latest/cli/pr/list.md#inherited-config) | stringArray | path to a config TOML, repeatable, later files win over earlier ones |
| [`--engine`](https://komrad.dev/latest/cli/pr/list.md#inherited-engine) | string | engine to reach: local for this machine, or a file in the config's engines directory, layered over the config |
