Shell Completion

The xyz completion command generates shell completion scripts for faster command entry.

Supported Shells

Shell	Command
Bash	`xyz completion bash`
Zsh	`xyz completion zsh`
Fish	`xyz completion fish`
PowerShell	`xyz completion powershell`

Installation

Bash
Zsh
Fish
PowerShell

Temporary (Current Session)

source <(xyz completion bash)

Permanent (Add to Profile)

Add to ~/.bashrc:

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

System-Wide

xyz completion bash > /etc/bash_completion.d/xyz

System-wide installation requires root/sudo access.

Temporary (Current Session)

source <(xyz completion zsh)

Permanent (Add to Profile)

Add to ~/.zshrc:

echo 'source <(xyz completion zsh)' >> ~/.zshrc
source ~/.zshrc

Via fpath

xyz completion zsh > "${fpath[1]}/_xyz"

If completions don’t work, you may need to add:

autoload -U compinit && compinit

Temporary (Current Session)

xyz completion fish | source

Permanent

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

Temporary (Current Session)

xyz completion powershell | Out-String | Invoke-Expression

Permanent (Add to Profile)

Add to your PowerShell profile:

# Find profile location
echo $PROFILE

# Add completion
Add-Content $PROFILE "xyz completion powershell | Out-String | Invoke-Expression"

Usage

After installation, press Tab to complete commands:

xyz ke<Tab>      # Completes to: xyz keys
xyz keys ge<Tab> # Completes to: xyz keys generate
xyz prog<Tab>    # Completes to: xyz program

Command Completion

xyz <Tab><Tab>
# Shows all available commands:
# balance    chain      completion config     help
# init       keys       localnet   program    token      tx

Subcommand Completion

xyz program <Tab><Tab>
# Shows subcommands:
# build    deploy   execute  info     list     query

Flag Completion

xyz balance --<Tab><Tab>
# Shows flags:
# --all    --help   --key    --node   --output

Completion Features

Command Descriptions

With zsh and fish, completions include descriptions:

xyz <Tab>
balance    -- Query account balance
chain      -- Chain information commands
completion -- Generate shell completion script
config     -- Configuration management
...

Dynamic Completions

Some completions are context-aware:

xyz balance --output <Tab>
# Shows: table  json

xyz config set keyring-backend <Tab>
# Shows: os  file  test

Troubleshooting

Completions not working (Bash)

Ensure bash-completion is installed:macOS:

brew install bash-completion

Ubuntu/Debian:

apt install bash-completion

Add to ~/.bashrc:

[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && \
  source "/usr/local/etc/profile.d/bash_completion.sh"

Completions not working (Zsh)

Enable completion system in ~/.zshrc:

autoload -U compinit && compinit

Reload:

source ~/.zshrc

Old completions cached

Remove cached completions and regenerate:Zsh:

rm -f ~/.zcompdump*
compinit

Bash:

complete -r xyz
source <(xyz completion bash)

Permission denied

For system-wide installation:

sudo xyz completion bash > /etc/bash_completion.d/xyz

Verify Installation

Test that completions are working:

# Type this and press Tab
xyz ba<Tab>
# Should complete to: xyz balance

xyz keys <Tab><Tab>
# Should show: export  generate  import  list

If completions work, you’re all set. If not, check the troubleshooting section above.

Getting Started

Chain

Products

Developer Tools

Token Operations

Smart Contracts

Local Development

Chain API

Launchpad API

Shell Completion

Shell Completion

Supported Shells

Installation

Temporary (Current Session)

Permanent (Add to Profile)

System-Wide

Temporary (Current Session)

Permanent (Add to Profile)

Via fpath

Temporary (Current Session)

Permanent

Temporary (Current Session)

Permanent (Add to Profile)

Usage

Command Completion

Subcommand Completion

Flag Completion

Completion Features

Command Descriptions

Dynamic Completions

Troubleshooting

Verify Installation

​Shell Completion

​Supported Shells

​Installation

​Temporary (Current Session)

​Permanent (Add to Profile)

​System-Wide

​Temporary (Current Session)

​Permanent (Add to Profile)

​Via fpath

​Temporary (Current Session)

​Permanent

​Temporary (Current Session)

​Permanent (Add to Profile)

​Usage

​Command Completion

​Subcommand Completion

​Flag Completion

​Completion Features

​Command Descriptions

​Dynamic Completions

​Troubleshooting

​Verify Installation

Shell Completion

Supported Shells

Installation

Temporary (Current Session)

Permanent (Add to Profile)

System-Wide

Temporary (Current Session)

Permanent (Add to Profile)

Via fpath

Temporary (Current Session)

Permanent

Temporary (Current Session)

Permanent (Add to Profile)

Usage

Command Completion

Subcommand Completion

Flag Completion

Completion Features

Command Descriptions

Dynamic Completions

Troubleshooting

Verify Installation