magus-completion

Print a shell completion script

Synopsis

magus completion <bash|zsh|fish|powershell>

Description

Print a shell completion script to stdout. Every script registers both magus and the mgs shorthand.

Completes subcommands, the targets accepted by run and affected, the nouns accepted by describe, and each subcommand's flags. Project paths are completed live by shelling out to magus ls -o name, so they track the workspace instead of a baked-in list; outside a workspace they are simply empty.

Install differs per shell, and zsh is the one that bites:

bash source it from ~/.bashrc, which re-reads it from the binary on every new shell and so survives an upgrade: source <(magus completion bash) zsh write it to a directory on $fpath as _magus. The script ends by invoking its own completion function, so sourcing it from ~/.zshrc runs that outside a completion context and registers nothing. Regenerate the file after magus self update. fish write it to ~/.config/fish/completions/magus.fish, loaded on demand. powershell append it to $PROFILE. pwsh is accepted as an alias, for the cross-platform PowerShell binary's own name.

Examples

Bash: source from the rc, never goes stale

echo 'source <(magus completion bash)' >> ~/.bashrc

Zsh: install onto $fpath (not into ~/.zshrc)

magus completion zsh > ~/.zsh/completions/_magus

Fish

magus completion fish > ~/.config/fish/completions/magus.fish

PowerShell

magus completion powershell >> $PROFILE

See Also

magus(1), magus-ls(1), magus-describe(1), magus-where(1), magus-run(1), magus-affected(1), magus-x(1), magus-clean(1), magus-shell(1), magus-query(1), magus-refs(1), magus-explain(1), magus-path(1), magus-graph(1), magus-diff(1), magus-vcs(1), magus-session(1), magus-job(1), magus-notes(1), magus-queue(1), magus-watch(1), magus-events(1), magus-server(1), magus-broker(1), magus-mcp(1), magus-status(1), magus-buzz(1), magus-spell(1), magus-agent(1), magus-init(1), magus-doctor(1), magus-config(1), magus-man(1), magus-self(1), magus-version(1)