cli / cli/cli

Add --quiet support to pr checks --watch and run watch

Open
#13,992 2 comments 2 reactions 0 assignees View on GitHub
enhancement gh-pr gh-run stale
Dominant language
Go
Stars
46.3k
Forks
9k
Avg merge
2d 9h
Merged PRs (30d)
89

Description

### Describe the feature or problem you’d like to solve

I would first like to ask whether quiet watch output would be useful for coding agents.

When an agent waits for pull request checks or a workflow run to complete, it generally only needs the final result before deciding what to do next. Today, `gh pr checks --watch` and `gh run watch` continuously render intermediate status updates. These updates are useful for someone actively watching a terminal, but they can add unnecessary noise to an agent's context without providing an actionable result.

It may be helpful to let agents wait for completion while receiving only the final output, without changing the existing interactive behavior by default.

### Proposed solution

Add a `--quiet` option to both watch flows:

- `gh pr checks --watch --quiet`
- `gh run watch --quiet`

When enabled, the option would:

- Suppress intermediate refresh messages and status renders.
- Avoid alternate-screen progress updates.
- Print the normal final summary or run result after completion.
- Preserve the existing exit status behavior.

Without `--quiet`, both commands would continue to behave exactly as they do today.

### Additional context

The main question is whether these options would meaningfully improve agent workflows by avoiding unnecessary intermediate output. If another existing output mode or a different design would better address this use case, I would be happy to consider that instead.

If this seems useful, I happen to have a [PR](https://github.com/cli/cli/pull/13993) ready with the proposed implementation and tests. If it does not seem useful, please feel free to close both the issue and the [PR](https://github.com/cli/cli/pull/13993).

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.