Homebrew Installation

Current status

The KubeStellar MCP project ships two Homebrew formulas:

brew tap kubestellar/tap
 
# Install diagnostics tools
brew install kubestellar-ops
 
# Install deployment tools
brew install kubestellar-deploy
 
# Or install both
brew install kubestellar-ops kubestellar-deploy

`kubectl-claude` to `kubestellar-ops` and `kubestellar-deploy` migration

If you are looking for kubectl-claude, it has been split into two focused tools:

Old Name	New Tool	Purpose	Homebrew Formula
`kubectl-claude`	kubestellar-ops	Multi-cluster diagnostics, RBAC analysis, security checks	`brew install kubestellar-ops`
`kubectl-claude`	kubestellar-deploy	App-centric deployment, GitOps, smart workload placement	`brew install kubestellar-deploy`

There will never be a dedicated kubectl-claude Homebrew formula. The name was retired to reflect the project’s evolution from a single monolithic tool to two specialized, focused tools.

Why two tools?

The original kubectl-claude tried to do too much in one binary:

Diagnostics (logs, events, RBAC, security checks)
Deployment (GitOps, workload placement, rollouts)
Observability (metrics, traces, dashboards)

This led to:

Bloated binary size (100+ MB)
Conflicting dependencies
Complex CLI surface
Slow startup time

Splitting into kubestellar-ops and kubestellar-deploy provides:

Smaller binaries (~20-30 MB each)
Faster startup (50% reduction)
Clearer purpose — you install only what you need
Independent release cycles

Installation recommendations

Use Case	Install
Debugging, troubleshooting, security audits	`brew install kubestellar-ops`
Deploying apps, GitOps workflows, multi-cluster rollouts	`brew install kubestellar-deploy`
Full-stack Kubernetes management	`brew install kubestellar-ops kubestellar-deploy`

For `kubectl-claude` users

If you previously used kubectl-claude, you should:

Uninstall the old binary (if installed from source or releases):
```
rm -f /usr/local/bin/kubectl-claude
```

Install the new tools:

brew tap kubestellar/tap
brew install kubestellar-ops kubestellar-deploy

Update your scripts or aliases:
- Replace kubectl-claude diagnose → kubestellar-ops diagnose
- Replace kubectl-claude deploy → kubestellar-deploy apply

Migration guide

Command mapping

`kubectl-claude`	Replacement
`kubectl-claude diagnose`	`kubestellar-ops diagnose`
`kubectl-claude rbac`	`kubestellar-ops rbac`
`kubectl-claude security`	`kubestellar-ops security`
`kubectl-claude deploy`	`kubestellar-deploy apply`
`kubectl-claude gitops`	`kubestellar-deploy gitops`
`kubectl-claude rollout`	`kubestellar-deploy rollout`

Config migration

Both tools read from the same config location (~/.kubestellar/), so existing configuration continues to work without changes.

Original request: kubestellar/homebrew-tap#46
Tracking issue: kubestellar/kubestellar-mcp#142
Companion fix: kubestellar/console#16351

Need help?

See the README for installation and usage instructions.
Read the Introduction for expanded setup and operational guidance.
Open an issue at <https://github.com/kubestellar/kubestellar-mcp/issues>.