{"id":37172861,"url":"https://github.com/mpizala/kxctl","last_synced_at":"2026-01-14T20:12:56.748Z","repository":{"id":209593563,"uuid":"724046073","full_name":"mpizala/kxctl","owner":"mpizala","description":"kxctl is a command-line utility that enhances the usability of kubectl by applying filters and various commands across multiple Kubernetes contexts","archived":false,"fork":false,"pushed_at":"2025-06-24T05:53:41.000Z","size":3394,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-24T06:36:40.287Z","etag":null,"topics":["clusters","cross-cluster","kubectl","shell-ninja"],"latest_commit_sha":null,"homepage":"","language":"Go","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/mpizala.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}},"created_at":"2023-11-27T09:35:28.000Z","updated_at":"2025-06-24T05:51:57.000Z","dependencies_parsed_at":"2025-06-24T06:29:51.513Z","dependency_job_id":"33fc5fdc-538c-4047-bed4-8b3d7d847a7c","html_url":"https://github.com/mpizala/kxctl","commit_stats":null,"previous_names":["mpizala/kxctl"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/mpizala/kxctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpizala%2Fkxctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpizala%2Fkxctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpizala%2Fkxctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpizala%2Fkxctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mpizala","download_url":"https://codeload.github.com/mpizala/kxctl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpizala%2Fkxctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28434420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T18:57:19.464Z","status":"ssl_error","status_checked_at":"2026-01-14T18:52:48.501Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["clusters","cross-cluster","kubectl","shell-ninja"],"created_at":"2026-01-14T20:12:55.945Z","updated_at":"2026-01-14T20:12:56.738Z","avatar_url":"https://github.com/mpizala.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kxctl - kubectl for cross-cluster activities\n\nA command-line utility that enhances the usability of kubectl by applying filters and various commands across multiple Kubernetes contexts.\n\n## Features\n\n- Execute kubectl commands across multiple contexts\n- Filter contexts using include/exclude patterns\n- Filter output with grep functionality (supports basic patterns and regex)\n- Interactive progress tracking (press Enter during execution to see status)\n- Safety checks for write operations requiring explicit confirmation\n- Simplify common Kubernetes operations across multiple clusters\n\n## Installation\n\n### Using Homebrew (macOS and Linux)\n\n```bash\nbrew install mpizala/utils/kxctl\n```\n\n### Using Go\n\n```bash\ngo install github.com/mpizala/kxctl/cmd/kxctl@latest\n```\n\n## Usage\n\n```\nkxctl - Kubernetes Context Control\n\nUsage:\n  kxctl [command] [flags] [-- kubectl_command]\n\nCommands:\n  list        List available contexts\n  exec        Execute kubectl command on filtered contexts\n  status      Show pods not in Running or Succeeded state\n  version     Display version information\n  help        Display help information\n\nFlags:\n  -i, --include pattern   Include contexts matching pattern (can be used multiple times)\n  -e, --exclude pattern   Exclude contexts matching pattern (can be used multiple times)\n  -g, --grep pattern      Filter command output to lines matching pattern\n  -p, --parallel number   Limit parallel execution to specified number of contexts\n  -t, --timeout duration  Set timeout for kubectl commands (e.g. 30s, 1m, 2m30s)\n  -f, --force             Force execution of write operations\n  -A, --all-namespaces    Show resources across all namespaces (status command)\n  -h, --help              Display help information\n```\n\n### Examples\n\n```bash\n# List all contexts\nkxctl list\n\n# List contexts matching 'prod'\nkxctl list -i prod\n\n# Run a command on all contexts\nkxctl exec -- get pods\n\n# Run a command on contexts matching a pattern\nkxctl exec -i production -- get pods\n\n# Run a command excluding contexts matching a pattern\nkxctl exec -e staging -- get pods\n\n# Shorthand syntax (starting with flags implies 'exec')\nkxctl -i prod -- get pods\n\n# Run a write operation with force flag\nkxctl exec -f -i prod -- apply -f deployment.yaml\n\n# Show problematic pods in the current namespace\nkxctl status\n\n# Show problematic pods in production clusters\nkxctl status -i prod -A\n\n# Show problematic pods with additional kubectl args\nkxctl status -- -o json\n\n# Show problematic pods across namespace webapp\nkxctl status -- --namespace webapp\n\n# Run a command with a timeout (useful for slow or unresponsive clusters)\nkxctl exec -t 30s -- get pods\n\n# Filter kubectl output with pipe-like syntax using the --grep flag\nkxctl exec -g \"coredns|web-app\" -- get pods -A\n\n# Interactive progress tracking: run a command and press Enter during execution\n# to see which clusters are currently being processed\nkxctl exec -i prod -- get pods  # Press Enter while waiting to see progress\n\n# Limit parallel execution to prevent kubelogin or authentication issues\nkxctl exec -p 3 -i prod -- get pods\n```\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmpizala%2Fkxctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmpizala%2Fkxctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmpizala%2Fkxctl/lists"}