Skip to content

Add gh run watch guidance for GitHub Actions monitoring#3

Merged
xingyaoww merged 3 commits into
mainfrom
openhands/update-github-doc-gh-run-watch
Dec 15, 2025
Merged

Add gh run watch guidance for GitHub Actions monitoring#3
xingyaoww merged 3 commits into
mainfrom
openhands/update-github-doc-gh-run-watch

Conversation

@xingyaoww
Copy link
Copy Markdown
Member

Summary

This PR updates the GitHub skills documentation to instruct agents to prioritize using gh run watch for monitoring GitHub Actions workflow runs.

Changes

  • Added guidance in skills/github.md to use gh run watch (https://cli.github.com/manual/gh_run_watch) as the primary method for checking GitHub Actions status
  • Agents will fallback to basic API calls only if gh run watch is not successful

Context

This change relates to issue #1285 which aims to improve OpenHands' capacity at monitoring async actions like GitHub CI runs. The gh CLI tool is well-known to LLMs and provides a better interface for monitoring workflow runs than polling with basic API calls.

Benefits

  • Better async monitoring: gh run watch is specifically designed for watching workflow runs until completion
  • Familiar tool: LLMs have good knowledge of the GitHub CLI
  • Graceful fallback: Still supports basic API calls as a backup method

Closes #1285 (partial - addresses the GitHub CI monitoring aspect)

Co-authored-by: openhands openhands@all-hands.dev

@xingyaoww can click here to continue refining the PR

Instructs agents to prioritize gh run watch for monitoring GitHub Actions workflow runs, with fallback to basic API calls if needed.

Relates to issue #1285 - improving OH capacity at monitoring async actions.

Co-authored-by: openhands <openhands@all-hands.dev>
Comment thread skills/github.md Outdated
Comment thread skills/github.md Outdated
Co-authored-by: Engel Nyst <engel.nyst@gmail.com>
@xingyaoww
Copy link
Copy Markdown
Member Author

Thanks! @enyst

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants