Last modified July 23, 2026
Installing the Muster CLI
muster is a single, self-contained binary with no additional dependencies. This page explains how to install it and keep it current. For what the CLI does and which commands it offers, see the Muster CLI reference.
You only need the CLI for a terminal view of your fleet, the auth and context commands, or the local bridge (muster agent). Modern AI assistants connect to the Muster endpoint directly over HTTPS with nothing to install — see Set up your AI agent.
Download the binary
Download the build for your operating system and architecture from the latest Muster release, then move the binary into a directory on your PATH.
On Linux or macOS, once you have unpacked the downloaded archive:
sudo mv muster /usr/local/bin/muster
chmod +x /usr/local/bin/muster
Verify that the CLI is working:
muster version
You should see the CLI version and, if a running aggregator is reachable, the server version.
Keep it up to date
Update the installed CLI in place to the latest GitHub release:
muster self-update
See muster self-update for details.
Next steps
- Point the CLI at your endpoint with a named context.
- Authenticate to a remote aggregator.
- Set up your AI agent to connect your IDE.
Need help, got feedback?
We listen to your Slack support channel. You can also reach us at support@giantswarm.io. And of course, we welcome your pull requests!