{"id":19030356,"url":"https://github.com/chmouel/tkn-watch","last_synced_at":"2025-04-17T12:31:30.866Z","repository":{"id":40353520,"uuid":"489672746","full_name":"chmouel/tkn-watch","owner":"chmouel","description":"tkn-watch - watch a PipelineRuns on its way to success or failures","archived":true,"fork":false,"pushed_at":"2024-09-02T11:13:55.000Z","size":2096,"stargazers_count":13,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T08:27:20.168Z","etag":null,"topics":["cli","rust","tekton-pipelines"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chmouel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2022-05-07T12:52:55.000Z","updated_at":"2024-12-12T00:57:24.000Z","dependencies_parsed_at":"2023-10-01T21:38:11.277Z","dependency_job_id":"9e05a159-d11c-415d-afed-10a80cd4a55b","html_url":"https://github.com/chmouel/tkn-watch","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ftkn-watch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ftkn-watch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ftkn-watch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ftkn-watch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chmouel","download_url":"https://codeload.github.com/chmouel/tkn-watch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249341824,"owners_count":21254193,"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":["cli","rust","tekton-pipelines"],"created_at":"2024-11-08T21:17:41.449Z","updated_at":"2025-04-17T12:31:30.493Z","avatar_url":"https://github.com/chmouel.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Version](https://img.shields.io/crates/v/tkn-watch.svg)](https://crates.io/crates/tkn-watch) [![AUR](https://img.shields.io/aur/version/tkn-watch-bin)](https://aur.archlinux.org/packages/tkn-watch-bin) [![CICD](https://github.com/chmouel/tkn-watch/actions/workflows/rust.yaml/badge.svg)](https://github.com/chmouel/tkn-watch/actions/workflows/rust.yaml) [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)](https://github.com/pre-commit/pre-commit)\n\n# tkn-watch - watch a PipelineRuns on its way to success or failures\n\ntkn-watch is a simple extension to the [tkn](https://github.com/tektoncd/cli) command line tool that watches a PipelineRuns and exit with the PipelineRun status.\n\nIt mimics the behaviour of GitHub [cli](https://github.com/cli/cli) `run` `watch` command.\n\n## Screenshot\n\n![tkn-watch screenshot](.github/screenshot.png)\n\n## Demo\n\n\u003chttps://user-images.githubusercontent.com/98980/167365691-808bcd91-cb8b-4597-b5bd-57f544c2bc5e.mov\u003e\n\n## Installation\n\n### [Binaries](https://github.com/chmouel/tkn-watch/releases)\n\nGo to the [release](https://github.com/chmouel/tkn-watch/releases) page and grab the archive or package targeting your platform.\n\n### [Homebrew](https://homebrew.sh)\n\n```shell\nbrew tap chmouel/tkn-watch https://github.com/chmouel/tkn-watch\nbrew install tkn-watch\n```\n\n### [Crates.io](https://crates.io/crates/tkn-watch)\n\n```shell\ncargo install tkn-watch\n```\n\n### [Arch](https://aur.archlinux.org/packages/tkn-watch-bin)\n\nWith your favourite aurhelper for example [yay](https://github.com/Jguer/yay) :\n\n```shell\nyay -S tkn-watch-bin\n```\n\n### [Docker](https://github.com/chmouel/tkn-watch/pkgs/container/tkn-watch)\n\n```shell\ndocker run -i ghcr.io/chmouel/tkn-watch # don't forget to bind your kubeconfig\n```\n\n## Usage\n\n```shell\n% tkn watch \u003cpipelinerun-name\u003e\n```\n\nIf you don't have `tkn` cli installed you can call the plug-in directly with `tkn-watch`\n\nIf you don't specify a PipelineRun it will ask you nicely for a running\nPipelinerun to watch, auto-selecting one if there is only one running.\n\nWhen you give the flag `-l`/`--last` tkn-watch will use the last PipelineRun started.\n\nYou can use the flag `-n` to specify another namespace than the current one.\n\nYou can adjust the time to wait between checks with the flag `-r`/`--refresh-seconds`, the default is 3 seconds.\n\nIf you don't want a fancy output and just have it reporting quietly success or failure then you can use the `-q`/`--quiet` flag for this.\n\n`tkn watch` exit with the pipelinerun status, so you can do fancy things like (on macOS):\n\n```shell\ntkn watch -lq || osascript -e 'display notification \"PipelineRun Has Failed :(\"' \u0026\u0026 osascript -e 'display notification \"PipelineRun Has Succeeded, time to commit again :)\"'\n```\n\nIf you use [pipelines-as-code](https://github.com/openshift-pipelines/pipelines-as-code) it will detect the headers and show which event and sha this PR targets.\n\n![image](https://user-images.githubusercontent.com/98980/167487292-26cc77da-6f17-4c3a-87d6-ac7721500e03.png)\n\n\n## Copyright\n\n[Apache-2.0](./LICENSE)\n\n## Authors\n\nChmouel Boudjnah \u003c[@chmouel](https://twitter.com/chmouel)\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Ftkn-watch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchmouel%2Ftkn-watch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Ftkn-watch/lists"}