{"id":16479340,"url":"https://github.com/timebertt/kubectl-revisions","last_synced_at":"2026-02-15T08:01:30.897Z","repository":{"id":241174760,"uuid":"676421036","full_name":"timebertt/kubectl-revisions","owner":"timebertt","description":"🚀 Time-travel through your workload's revision history 🕰️","archived":false,"fork":false,"pushed_at":"2026-02-06T20:51:42.000Z","size":984,"stargazers_count":22,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-07T07:40:39.456Z","etag":null,"topics":["kubectl","kubectl-plugin","kubernetes"],"latest_commit_sha":null,"homepage":"","language":"Go","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/timebertt.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-09T06:55:43.000Z","updated_at":"2026-02-06T20:39:56.000Z","dependencies_parsed_at":"2024-05-29T07:17:37.801Z","dependency_job_id":"e31043c7-1225-4e81-af51-e4d42e0c2ae6","html_url":"https://github.com/timebertt/kubectl-revisions","commit_stats":null,"previous_names":["timebertt/kubectl-history","timebertt/kubectl-revisions"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/timebertt/kubectl-revisions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timebertt%2Fkubectl-revisions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timebertt%2Fkubectl-revisions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timebertt%2Fkubectl-revisions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timebertt%2Fkubectl-revisions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timebertt","download_url":"https://codeload.github.com/timebertt/kubectl-revisions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timebertt%2Fkubectl-revisions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29473358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T06:58:05.414Z","status":"ssl_error","status_checked_at":"2026-02-15T06:58:05.085Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["kubectl","kubectl-plugin","kubernetes"],"created_at":"2024-10-11T12:51:41.505Z","updated_at":"2026-02-15T08:01:30.542Z","avatar_url":"https://github.com/timebertt.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kubectl-revisions\n\n🚀 *Time-travel through your workload revision history* 🕰️\n\n## About\n\n`kubectl-revisions` is a [kubectl plugin](https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/) and can be invoked as `kubectl revisions`, or for short `k revisions`.\n\nThe `revisions` plugin allows you to go back in time in the history of revisions and answers common questions like \"Why was my Deployment rolled?\"\n\nIt gives more output than `kubectl rollout history` and is easier to use than `kubectl get replicaset` or `kubectl get controllerrevision`.\n\n## Installation\n\nUsing [krew](https://krew.sigs.k8s.io/) (recommended):\n\n```bash\nkubectl krew install revisions\n```\n\nUsing go:\n\n```bash\ngo install github.com/timebertt/kubectl-revisions@latest\n```\n\nSet up shell completion ([docs](docs/kubectl_revisions_completion.md)):\n\n```bash\nkubectl revisions completion -h\n```\n\n## Usage\n\nAlso see the [reference docs](docs/kubectl_revisions.md).\n\n### `k revisions get` / `k revisions list`\n\nGet the revision history of a workload resource (`Deployment`, `StatefulSet`, or `DaemonSet`).\n\n![Screenshot of kubectl revisions get](docs/assets/get.png)\n\u003c!-- generated with:\ntermshot --show-cmd -f docs/assets/get.png -- kubectl revisions get deploy nginx -owide\n--\u003e\n\nThe history is based on the `ReplicaSets`/`ControllerRevisions` still in the system. I.e., the history is limited by the\nconfigured `revisionHistoryLimit`.\n\nBy default, all revisions are printed as a list. If the `--revision` flag is given, the selected revision is printed\ninstead.\nThis is similar to using `k get replicaset` or `k get controllerrevision`, but allows easy selection of the relevant objects and returns a sorted list.\nThis is also similar to `k rollout history`, but doesn't only print revision numbers.\n\n### `k revisions diff` / `k revisions why`\n\nCompare multiple revisions of a workload resource (`Deployment`, `StatefulSet`, or `DaemonSet`).\nA.k.a., \"Why was my Deployment rolled?\"\n\n![Screenshot of kubectl revisions diff](docs/assets/diff.png)\n\u003c!-- generated with:\ntermshot --show-cmd -f docs/assets/diff.png --edit -- kubectl revisions diff deploy nginx\n--\u003e\n\nThe history is based on the `ReplicaSets`/`ControllerRevisions` still in the system. I.e., the history is limited by the\nconfigured `revisionHistoryLimit`.\n\nBy default, the latest two revisions are compared. The `--revision` flag allows selecting the revisions to compare.\n\nThe `k revisions diff` command uses `diff -u -N` to compare revisions by default.\nIt also respects the `KUBECTL_EXTERNAL_DIFF` environment variable like the `kubectl diff` command.\nTo get a nicer diff output, you can use one of these:\n\n```bash\n# Use a colored external diff program\nexport KUBECTL_EXTERNAL_DIFF=\"colordiff -u\"\n# Use dyff as a rich diff program\nexport KUBECTL_EXTERNAL_DIFF=\"dyff between --omit-header\"\n# Show diff in VS Code\nexport KUBECTL_EXTERNAL_DIFF=\"code --diff --wait\"\n```\n\nFor example:\n\n![Screenshot of kubectl revisions diff using dyff](docs/assets/diff-dyff.png)\n\u003c!-- generated with:\ntermshot --show-cmd -f docs/assets/diff-dyff.png -- KUBECTL_EXTERNAL_DIFF='\"dyff between --omit-header\"' kubectl revisions diff deploy nginx\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimebertt%2Fkubectl-revisions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimebertt%2Fkubectl-revisions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimebertt%2Fkubectl-revisions/lists"}