Skip to content
ghostshell

Shell completion

Enable bash tab-completion for ghostshell subcommands, flags, local sessions, and - as root - users and central session IDs.

The deb/rpm packages install bash completion to /usr/share/bash-completion/completions/ghostshell. If you installed the static binary or built from source, enable it manually:

bash
ghostshell completion bash | sudo tee /usr/share/bash-completion/completions/ghostshell

Open a new shell (or source the file) and completion is active.

What it completes

  • Subcommands and flags for every command
  • Local session files, for ghostshell play <Tab>
  • When run as root: users (for ls --user <Tab>) and central session IDs

Examples:

console
$ ghostshell p<Tab> play prune $ ghostshell play 2026<Tab> # completes your local sessions $ sudo ghostshell ls --user a<Tab> # completes users in the central store

Note: Session-ID and user completion for central-store commands only works as root, because completion reads the same root-only store the commands do.

You can also print the script without installing it — useful for inspecting what it does or vendoring it into configuration management:

bash
ghostshell completion bash

Source of truth: README on GitHub