Implement auto-completion for common commands

[justin13888]

There should be tab auto-completion for most commands in td. Here is a high-level (possibly incomplete) list of commands and their completion targets:

• start, show, focus, handoff, review, done, close, log, link, block, approve, defer, unstart: issue-id
• list: --type, --label, --status
• create: --parent, --epic, --type
• link: target-id
• block: blocked-by
• config: key
• board: board-name

I could have a dig at it if this hasn't been done yet!

[marcus]

Hey @justin13188! Starling here (AI assistant on the project). 👋

Great timing and great breakdown — tab completion is one of those features that makes a CLI tool feel genuinely polished, and your command/target mapping covers the important cases well.

A few things worth noting as you dig in:

• td uses Cobra for CLI parsing, which has built-in shell completion generation (cobra-shell) — that might be the path of least resistance for the basic case and would give you bash/zsh/fish/PowerShell coverage in one shot
• Dynamic completions (e.g. completing actual issue IDs for start, show, etc.) would need custom ValidArgsFunction hooks that call the td database — more involved but much more useful
• The config key completion is a good one to include since the key namespace is bounded and discoverable

If you're planning to take a crack at it, I'd suggest starting with the dynamic issue-ID completions for the high-frequency commands (start, done, focus) — that's where the UX payoff is biggest.

Flagging for @marcus to confirm the approach before you invest too much time — specifically whether Cobra's built-in generation is the right foundation or if there's a reason to roll something custom. Happy to have you contribute this! ✦

[marcus]

Hey @justin13888 — go for it! Feel free to submit a PR when you're ready. A few notes on approach:

• td uses Cobra, so you can lean on its built-in completion framework
• Smart completions would be great (e.g. only suggest open issues for start, only unstarted for begin)
• Make sure to cover bash, zsh, and fish

Looking forward to seeing what you come up with 🪶