Shell Completion

April 9, 2026 ยท View on GitHub

Squix provides intelligent tab completion for bash, zsh, and fish. Completions are dynamic - they automatically include your saved queries and connections.

Installation

Bash
# Temporary (current session)
source <(squix completion bash)

# Permanent (add to ~/.bashrc)
echo 'eval "$(squix completion bash)"' >> ~/.bashrc
Zsh
# Temporary (current session)
autoload -U compinit && compinit
source <(squix completion zsh)

# Permanent (add to ~/.zshrc)
echo 'autoload -U compinit && compinit' >> ~/.zshrc
echo 'eval "$(squix completion zsh)"' >> ~/.zshrc
Fish
# Fish loads completions automatically from ~/.config/fish/completions/
squix completion fish > ~/.config/fish/completions/squix.fish
# Restart your shell or run: exec fish

Usage

After installation, press TAB to autocomplete:

squix [TAB]              # List all commands
squix run [TAB]          # List queries from current connection
squix switch [TAB]       # List connection names
squix info [TAB]         # List: table, view
squix list [TAB]         # List: queries
squix edit [TAB]         # List queries to edit

Note: Query completion only shows queries from your current connection. Use squix switch <connection> to change connections.

Currently unreleased, build from source to make this available