{"id":19324824,"url":"https://github.com/spatie/github-actions-watcher","last_synced_at":"2025-04-12T21:34:54.767Z","repository":{"id":41872986,"uuid":"434342547","full_name":"spatie/github-actions-watcher","owner":"spatie","description":"A CLI tool to see the status of your all GitHub Actions workflows in real time","archived":false,"fork":false,"pushed_at":"2025-01-27T12:32:30.000Z","size":21824,"stargazers_count":124,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-04T01:10:00.517Z","etag":null,"topics":["actions","github","watcher"],"latest_commit_sha":null,"homepage":"https://spatie.be/open-source","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spatie.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"spatie"}},"created_at":"2021-12-02T19:07:12.000Z","updated_at":"2025-02-01T18:58:31.000Z","dependencies_parsed_at":"2023-02-16T07:15:17.430Z","dependency_job_id":"553114ee-3edb-429d-9a40-ce6f96c7c93a","html_url":"https://github.com/spatie/github-actions-watcher","commit_stats":{"total_commits":137,"total_committers":7,"mean_commits":"19.571428571428573","dds":"0.16058394160583944","last_synced_commit":"aec87dbe97728a3b7c10c71f594f8001e5396603"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":"spatie/package-skeleton-php","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fgithub-actions-watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fgithub-actions-watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fgithub-actions-watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatie%2Fgithub-actions-watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spatie","download_url":"https://codeload.github.com/spatie/github-actions-watcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248637181,"owners_count":21137530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","github","watcher"],"created_at":"2024-11-10T02:06:54.793Z","updated_at":"2025-04-12T21:34:54.718Z","avatar_url":"https://github.com/spatie.png","language":"PHP","funding_links":["https://github.com/sponsors/spatie"],"categories":[],"sub_categories":[],"readme":"\n[\u003cimg src=\"https://github-ads.s3.eu-central-1.amazonaws.com/support-ukraine.svg?t=1\" /\u003e](https://supportukrainenow.org)\n\n# A CLI tool to see the status of all your GitHub Actions workflows in real time\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/spatie/github-actions-watcher.svg?style=flat-square)](https://packagist.org/packages/spatie/github-actions-watcher)\n[![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)\n[![Total Downloads](https://img.shields.io/packagist/dt/spatie/github-actions-watcher.svg?style=flat-square)](https://packagist.org/packages/spatie/github-actions-watcher)\n\nThe 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.\n\nBy 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.\n\n![screenshot](https://spatie.github.io/github-actions-watcher/tool.png)\n\n## Support us\n\n[\u003cimg src=\"https://github-ads.s3.eu-central-1.amazonaws.com/github-actions-watcher.jpg?t=1\" width=\"419px\" /\u003e](https://spatie.be/github-ad-click/github-actions-watcher)\n\nWe 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).\n\nWe 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).\n\n## Source diving this tool\n\nIn [this stream on YouTube](https://www.youtube.com/watch?v=fkBuSR6_OuE), we'll guide you through the entire source code of the tool.\n\n## Installation\n\nYou can install the tool via composer:\n\n```bash\ncomposer global require spatie/github-actions-watcher\n```\n\n## Usage\n\nYou can just execute the tool on your cli.\n\n```bash\nactions-watcher\n```\n\n\nBy 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.\n\n## Authenticating with GitHub\n\nTo 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.\n\nYou can authenticate with GitHub by executing this command:\n\n```bash\nactions-watcher login\n```\n\nAfter 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.\n\nTo destroy the token on your hard disk, execute the `logout` command.\n\n```\nactions-watcher logout\n```\n\n## Single pass\n\nIf you don't want to poll for new results, but just want to see current results use the `--single-pass` option\n\n```bash\nactions-watcher --single-pass\n```\n\n## Using an alternative repo and/or branch\n\nBy 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. \n\nIf you want to use another repo or branch, use the `--repo` and `--branch` flags.\n\n```bash\nactions-watcher --repo=your-organisation/your-repo-name --branch=other-branch\n```\n\n## Testing\n\n```bash\ncomposer test\n```\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.\n\n## Security Vulnerabilities\n\nPlease review [our security policy](../../security/policy) on how to report security vulnerabilities.\n\n## Credits\n\n- [Freek Van der Herten](https://github.com/freekmurze)\n- [All Contributors](../../contributors)\n\nA 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.\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatie%2Fgithub-actions-watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspatie%2Fgithub-actions-watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatie%2Fgithub-actions-watcher/lists"}