Shell completions (bash, zsh, fish)

[elijahr]

Problem

Spellbook's CLI has no shell completions. Tab completion for commands, skill names, and options is a developer experience win that makes the tool feel polished and professional.

Scope

Generate completion scripts for:

• bash - .bash_completion or sourced script
• zsh - _spellbook completion function
• fish - spellbook.fish completions

What to Complete

• Top-level commands (install, start, stop, etc.)
• Skill names (dynamically from installed skills)
• Command names (dynamically from installed commands)
• Flag names and values

Implementation Options

1. Click/Typer built-in - If the CLI uses Click or Typer, completion generation is built in
2. argcomplete - Works with argparse-based CLIs
3. Manual - Write completion scripts directly

This is a Good First Issue Because

• Well-scoped and self-contained
• Does not require deep knowledge of spellbook internals
• Clear success criteria (completions work in the target shell)
• Lots of examples to reference from other Python CLI tools

[vbhavh]

/assign

[vbhavh]

@elijahr

[elijahr]

@vbhavh do you want to be assigned this issue?

[vbhavh]

yup! @elijahr

[elijahr]

@vbhavh done! thanks for your interest!

[vbhavh]

hey @elijahr , where are the skills names ?

[elijahr]

@vbhavh The directory listing at https://github.com/axiomantic/spellbook/tree/main/skills always has the most up-to-date list, but the Skills A-Z has nav links for them all, if you are looking for documentation. Do either of those work for what you need?