PHPackages spatie/github-actions-watcher - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. spatie/github-actions-watcher ActiveLibrary[CLI & Console](/categories/cli) spatie/github-actions-watcher ============================= A CLI tool to see the status of all your GitHub Actions workflows in real time 1.0.9(5mo ago)1328158MITPHPPHP ^8.0CI passing Since Dec 3Pushed 1mo ago1 watchersCompare [ Source](https://github.com/spatie/github-actions-watcher)[ Packagist](https://packagist.org/packages/spatie/github-actions-watcher)[ Docs](https://github.com/spatie/github-actions-watcher)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-github-actions-watcher/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (12)Versions (28)Used By (0) A CLI tool to see the status of all your GitHub Actions workflows in real time ============================================================================== [](#a-cli-tool-to-see-the-status-of-all-your-github-actions-workflows-in-real-time) [![Latest Version on Packagist](https://camo.githubusercontent.com/d6cd8ec3214f633e4688638c8e16f098f480ca3adf5df2634dbef69d453e55b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6769746875622d616374696f6e732d776174636865722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/github-actions-watcher)[![Tests](https://github.com/spatie/github-actions-watcher/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/spatie/github-actions-watcher/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/a1f84e84cc53a827892ae6895febecfa968ec21e1b977afa825b0720739f0896/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6769746875622d616374696f6e732d776174636865722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/github-actions-watcher) The official GitHub CLI allows you to monitor a single workflow on the terminal. Using our GitHub Actions Watcher tool you can monitor the results of all your GitHub Actions. When installed, you can just execute `actions-watcher` to see all results. By default, the watcher will use the git repo and branch of the directory it is launched in. It will keep polling and refreshing results until all workflows of your repo have been completed. [![screenshot](https://camo.githubusercontent.com/8f62c963111af304e5b2490f85cbd1ff50ef2ae61d82dbf563d3c54ceb6f1ed6/68747470733a2f2f7370617469652e6769746875622e696f2f6769746875622d616374696f6e732d776174636865722f746f6f6c2e706e67)](https://camo.githubusercontent.com/8f62c963111af304e5b2490f85cbd1ff50ef2ae61d82dbf563d3c54ceb6f1ed6/68747470733a2f2f7370617469652e6769746875622e696f2f6769746875622d616374696f6e732d776174636865722f746f6f6c2e706e67) Support us ---------- [](#support-us) [![](https://camo.githubusercontent.com/03f382c1594ddd763171637cd64db3ab190e59dbea2403775dded7616c59e8cc/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6769746875622d616374696f6e732d776174636865722e6a70673f743d31)](https://spatie.be/github-ad-click/github-actions-watcher) We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards). Source diving this tool ----------------------- [](#source-diving-this-tool) In [this stream on YouTube](https://www.youtube.com/watch?v=fkBuSR6_OuE), we'll guide you through the entire source code of the tool. Installation ------------ [](#installation) You can install the tool via composer: ``` composer global require spatie/github-actions-watcher ``` Usage ----- [](#usage) You can just execute the tool on your cli. ``` actions-watcher ``` By default, the watcher will use the git repo and branch of the directory it is launched in. It will keep polling and refreshing results until all workflows of your repo have been completed. Authenticating with GitHub -------------------------- [](#authenticating-with-github) To see results of private repos, you must authenticate with GitHub. Even when working with public repos, we highly recommend authenticating, as you'll get higher rate limit when the tools communicates with GitHub. You can authenticate with GitHub by executing this command: ``` actions-watcher login ``` After having completed the login flow, a token will be stored on your disk. At no point, Spatie can see any data of your repos or user. To destroy the token on your hard disk, execute the `logout` command. ``` actions-watcher logout ``` Single pass ----------- [](#single-pass) If you don't want to poll for new results, but just want to see current results use the `--single-pass` option ``` actions-watcher --single-pass ``` Using an alternative repo and/or branch --------------------------------------- [](#using-an-alternative-repo-andor-branch) By default, the watcher will use the git repo and branch of the directory it is launched in. It will keep polling and refreshing results until all workflows of your repo have been completed. If you want to use another repo or branch, use the `--repo` and `--branch` flags. ``` actions-watcher --repo=your-organisation/your-repo-name --branch=other-branch ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [All Contributors](../../contributors) A big thank you to [Francisco Madeira](https://github.com/xiCO2k) and [Owen Voke](https://github.com/owenvoke) for helping us with the layout of the screens. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 52 — FairBetter than 96% of packages Maintenance82 Actively maintained with recent releases Popularity31 Limited adoption so far Community18 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 75.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~63 days Recently: every ~343 days Total 24 Last Release 175d ago Major Versions 0.0.2 → 1.0.02022-02-03 0.14.0 → 1.0.12022-02-21 PHP version history (2 changes)0.0.1PHP ^8.1 1.0.0PHP ^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (146 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (21 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (15 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (4 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (2 commits)")[![guanguans](https://avatars.githubusercontent.com/u/22309277?v=4)](https://github.com/guanguans "guanguans (2 commits)")[![pelmered](https://avatars.githubusercontent.com/u/680058?v=4)](https://github.com/pelmered "pelmered (1 commits)")[![thecaliskan](https://avatars.githubusercontent.com/u/13554944?v=4)](https://github.com/thecaliskan "thecaliskan (1 commits)")[![xiCO2k](https://avatars.githubusercontent.com/u/823088?v=4)](https://github.com/xiCO2k "xiCO2k (1 commits)") --- Tags actionsgithubwatcherspatiegithub-actions-watcher ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/spatie-github-actions-watcher/health.svg) ``` [![Health](https://phpackages.com/badges/spatie-github-actions-watcher/health.svg)](https://phpackages.com/packages/spatie-github-actions-watcher) ``` ### Alternatives [wp-cli/wp-cli WP-CLI framework 5.1k17.2M320](/packages/wp-cli-wp-cli)[spatie/laravel-signal-aware-command Handle signals in artisan commands 16713.2M2](/packages/spatie-laravel-signal-aware-command)[consolidation/annotated-command Initialize Symfony Console commands from annotated command class methods. 22569.8M19](/packages/consolidation-annotated-command)[seld/cli-prompt Allows you to prompt for user input on the command line, and optionally hide the characters they type 24725.8M17](/packages/seld-cli-prompt)[illuminate/console The Illuminate Console package. 12944.1M5.1k](/packages/illuminate-console)[spatie/laravel-remote Execute Artisan commands on remote servers 28384.9k2](/packages/spatie-laravel-remote) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)