# Update Completions

> Update fish shell completions for the GitHub Copilot CLI based on its current help output. Use when asked to update, sync, or refresh completions, or when the CLI has been updated and completions need to match the latest flags, subcommands, and help topics.

- Skill: `scaryrawr/update-completions` (Agent Skill)
- Install (CLI): `npx skillmds@latest add scaryrawr/update-completions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/scaryrawr/update-completions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: scaryrawr (https://skillmd.com/u/scaryrawr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/scaryrawr/update-completions

---


# Update Copilot CLI Fish Completions

## When to Use

- When the Copilot CLI has been updated and completions may be out of date
- When asked to update, sync, or refresh the fish completions
- When new flags, subcommands, or help topics have been added to the CLI

## Instructions

1. Enumerate the current CLI surface area from the live help output. Treat `copilot help --help` as the source of truth for help topics instead of assuming a fixed list.
   ```sh
   copilot --help
   copilot help --help
   copilot help commands
   copilot help config
   copilot help environment
   copilot help logging
   copilot help monitoring
   copilot help permissions
   copilot help providers
   copilot init --help
   copilot update --help
   copilot version --help
   copilot login --help
   copilot mcp --help
   copilot mcp add --help
   copilot mcp get --help
   copilot mcp list --help
   copilot mcp remove --help
   copilot plugin --help
   copilot plugin install --help
   copilot plugin uninstall --help
   copilot plugin update --help
   copilot plugin list --help
   copilot plugin marketplace --help
   copilot plugin marketplace add --help
   copilot plugin marketplace remove --help
   copilot plugin marketplace list --help
   copilot plugin marketplace browse --help
   ```

   If `copilot help --help` lists additional topics beyond the current set, run `copilot help <topic>` for those too.

2. Compare the help output against the existing completions and helper functions:
   - `completions/copilot.fish`
   - relevant `functions/__fish_copilot_*.fish` helpers for dynamic arguments

3. Update `completions/copilot.fish` and any relevant helper functions to reflect changes:
   - Add completions for new flags and options
   - Remove completions for deprecated/removed flags
   - Update descriptions to match current help text
   - Add new subcommands or help topics
   - Add or update dynamic helper functions when commands accept discoverable names (for example models, agents, marketplaces, plugins, or MCP servers)
   - Use `-x` for exclusive arguments, `-r` for required arguments, `-f` to disable file completion
   - Every completion needs a `-d` description

4. Update the fallback model list in `functions/__fish_copilot_models.fish` if the set of available models has changed. Parse the model list from `copilot help config` under the `model` setting, since that help topic is the authoritative list.

5. Validate changes:
   ```fish
   fish -n completions/copilot.fish
   fish -n functions/*.fish

   # Run targeted completion probes for the surfaces you changed.
   complete -C"copilot --mo"
   complete -C"copilot help "
   complete -C"copilot mcp "
   complete -C"copilot plugin marketplace "
   ```

## Key Files

- `completions/copilot.fish` — All CLI completions using `complete -c copilot` syntax
- `functions/__fish_copilot_models.fish` — Dynamic model list with fallback values
- `functions/__fish_copilot_agents.fish` — Dynamic agent list from `~/.copilot/agents/`
- `functions/__fish_copilot_*.fish` — Other dynamic argument helpers, including marketplaces, plugins, and MCP servers

## Conventions

- Disable file completion with `-f` when appropriate
- Use `__fish_use_subcommand` condition for top-level subcommand completions
- Use `__fish_seen_subcommand_from` condition for subcommand-specific completions
- Use the live help output as the source of truth; avoid assuming help topics or command trees are static
- 4 spaces indentation
- Keep completions grouped by section with comments