Musher Commands

Complete command reference for the musher CLI.

Authentication

musher login

Authenticate with the Musher platform using your API key.

bash

musher login

Prompts for your API key interactively. The credential is stored in your OS keyring (or a fallback file). See Configuration for storage details.

musher logout

Clear stored credentials from your machine.

bash

musher logout

musher whoami

Display your authenticated identity and writable namespaces.

bash

musher whoami

Output

User:       [email protected]
Namespaces: acme (owner), acme-labs (member)

Bundle Authoring

musher init

Scaffold a new musher.yaml in the current directory with default fields.

bash

musher init

Flag	Description
`--namespace <name>`	Pre-fill the namespace field
`--slug <name>`	Pre-fill the bundle slug

Example

musher init --namespace acme --slug code-review-kit

musher validate

Validate the bundle definition and verify that all referenced source files exist.

bash

musher validate

Output

✓ musher.yaml is valid
✓ 3 assets found
✓ All source files exist
✓ Bundle is ready to publish

Flag	Description
`--file <path>`	Path to `musher.yaml` (default: current directory)

Publishing

musher publish

Validate the bundle and publish an immutable version to the registry.

bash

musher publish

Output

✓ Bundle validated
✓ Published acme/code-review-kit:1.0.0
  OCI ref: registry.musher.dev/acme/code-review-kit:1.0.0

Flag	Description
`--file <path>`	Path to `musher.yaml` (default: current directory)
`--dry-run`	Validate and show what would be published without actually publishing

musher yank

Soft-withdraw a published version from resolution. Yanked versions won't be returned by resolve queries but remain visible in detail views for audit purposes.

bash

musher yank <namespace>/<slug>:<version>

Example

musher yank acme/code-review-kit:1.0.0

Flag	Description
`--reason <text>`	Record why the version was yanked (recommended)

musher unyank

Restore a previously yanked version, making it available for resolution again.

bash

musher unyank <namespace>/<slug>:<version>

Example

musher unyank acme/code-review-kit:1.0.0

Utilities

musher doctor

Run diagnostic checks on your environment — verifies authentication, registry connectivity, and CLI configuration.

bash

musher doctor

Output

✓ CLI version: 0.4.2
✓ Authenticated as [email protected]
✓ Registry reachable: registry.musher.dev
✓ Keyring available

musher update

Update the musher CLI to the latest version.

bash

musher update

musher version

Display the installed CLI version and build information.

bash

musher version

Output

musher 0.4.2
commit: a1b2c3d
built:  2026-03-15T10:30:00Z

musher completion

Generate shell completion scripts for your terminal.

bash

# Add to ~/.bashrc
eval "$(musher completion bash)"