Shell Autocomplete

Devsync supports shell autocomplete for bash, zsh, and powershell. Once set up, pressing Tab will complete command names, flags, and subcommand arguments.

---

Generating the Completion Script

Devsync can print a shell-specific completion script to stdout:

devsync autocomplete bash
devsync autocomplete zsh
devsync autocomplete powershell

The output is a shell script that you source in your shell’s startup file to enable completion.

---

Setup

bash

Add the following line to your ~/.bashrc:

eval "$(devsync autocomplete bash)"

Then reload your shell:

source ~/.bashrc

Note

If you prefer not to evaluate on every shell startup (for faster startup time), you can write the script to a file and source it:

devsync autocomplete bash > ~/.config/devsync/completion.bash
echo 'source ~/.config/devsync/completion.bash' >> ~/.bashrc
source ~/.bashrc

Remember to re-run devsync autocomplete bash > ~/.config/devsync/completion.bash after upgrading devsync.

zsh

Add the following line to your ~/.zshrc:

eval "$(devsync autocomplete zsh)"

Then reload your shell:

source ~/.zshrc

Note

For faster startup, write the script to a file and source it:

devsync autocomplete zsh > ~/.config/devsync/completion.zsh
echo 'source ~/.config/devsync/completion.zsh' >> ~/.zshrc
source ~/.zshrc

Remember to re-run the generation step after upgrading devsync.

powershell

Run the following to append the completion script to your PowerShell profile:

devsync autocomplete powershell >> $PROFILE

Then reload your profile:

. $PROFILE

Note

If $PROFILE doesn’t exist yet, create it first:

New-Item -ItemType File -Path $PROFILE -Force

---

What Gets Completed

After setup, Tab completion works for:

• Top-level commands: push, pull, track, untrack, status, init, doctor, cd, profile, autocomplete
• Subcommands: profile list, profile use
• Flags: --mode, --profile, --dry-run, --verbose, etc.
• Flag values: --mode completes to normal, secret, ignore

---

Tracking Your Completion Script with devsync

If you track your .bashrc or .zshrc with devsync, the eval line will be synced automatically to new machines. After pulling on a new machine, the autocomplete will work as soon as you reload your shell.

devsync track ~/.zshrc