Shell Integration

Shell Integration

Rona ships with a completion subcommand that generates tab-completion scripts for Bash, Fish, Zsh, and PowerShell.

Setup

Fish

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

Reload with source ~/.config/fish/config.fish or open a new terminal.

Fish gets an extra completion: rona -a <TAB> (as well as rona reset <TAB> and rona restore <TAB>) lists files from git status, so you can interactively pick what to stage, unstage or discard.

Bash

rona completion bash >> ~/.bashrc
source ~/.bashrc

Zsh

rona completion zsh >> ~/.zshrc
source ~/.zshrc

PowerShell

rona completion powershell | Out-File -Append $PROFILE
. $PROFILE

Usage

Once installed, press <TAB> after any partial command or flag:

rona <TAB>              # list subcommands
rona -g -<TAB>          # list flags for generate
rona -a <TAB>           # list staged/unstaged files (Fish only)
rona reset <TAB>        # list staged files to unstage (Fish only)
rona restore <TAB>      # list changed files to discard (Fish only)

Troubleshooting

Completions not working after install

• Make sure you reloaded the shell config or opened a new terminal.
• Verify the file was written: cat ~/.config/fish/completions/rona.fish (Fish) or check the relevant rc file.

Regenerating completions after a Rona update

• Re-run the same setup command to overwrite the old script with the updated one.

Next Steps

• Usage Guide
• Command Reference