Build and maintain carapace shell completions for command-line tools. The reference covers YAML specs, custom completion actions, shell setup, DSL-aware parsing, MCP use, and documentation for suggested values.
Use when working with carapace shell completion — integrating into CLIs, writing YAML specs, creating custom actions, building completion-aware lexers for DSLs, looking up macros, setting up shell completion, configuring choices/bridges, using the MCP server, or adding man page documentation.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Reference for using carapace shell completion — integrating into CLIs, writing specs, creating actions, and configuring completions.
Load the reference that matches your task. When in doubt, load multiple references.
| Keywords | Reference |
|---|---|
| Integrate carapace, cobra, PreRun, PreInvoke, bridge, standalone mode, flag config, non-POSIX flags | references/integrate.md |
| Effective actions, ActionValues, ActionCallback, ActionExecCommand, modifiers, naming, caching, batch, MultiParts, UID, tags, linting, carapace:curated | references/action.md |
| YAML spec, user spec, flags, subcommands, parsing modes, exclusiveflags, aliases, completion, macros, modifiers, runnable specs | references/spec.md |
| Macro format, MacroN, MacroI, MacroV, $files, macro signatures, modifier chaining | references/macro.md |
| Choices, variants, bridges, CARAPACE_BRIDGES, --choice, --list, group priority | references/choice.md |
| Setup, shell integration, environment variables, overlays, extensions, install | references/setup.md |
| Environment variable completion, env YAML, conditions, ActionNames, ActionValues | references/env.md |
| Convert spec to Go, codegen, macro-to-Go mapping, modifier translation | references/convert.md |
| Update existing completer, incremental update, new flags, new subcommands, surgical edits | references/update.md |
| Scrape spec, generate from source, Docker, supported frameworks, patch-and-container | references/scrape.md |
| MCP server, complete tool, list_macros tool, codegen tool, JSON-RPC, stdio transport | references/mcp.md |
| Man pages, carapace-man, UID documentation, YAML man pages, inline descriptions, scheme, host, path | references/man.md |
| Lexer, parser, DSL completion, CompletionContext, ParseForCompletion, grammar package, completion-aware parser, argstream | references/lexer.md |
For internal library development (Action API internals, traverse engine, shell formatters, style system), use the carapace-dev skill (in the carapace repo).
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Use this reference to manage software with Homebrew on macOS or Linux, understand formulas and casks, maintain Brewfiles and services, troubleshoot installations, or work on formula and cask development tasks.
Use this reference to build and maintain terminal user interfaces in Go with Bubble Tea. It explains the Model/Update/View cycle, commands and messages, input, rendering, program lifecycle, tests, component composition, and patterns for larger applications.
Use this reference for JavaScript and TypeScript development with Bun. It explains CLI commands, dependency and lockfile management, testing, bundling code, runtime APIs for files and servers, the Bun shell, configuration, and environment variables.
Use this reference to manage Git work with the GitButler CLI (`but`), including virtual and stacked branches, assigning changes, editing commits, resolving conflicts, and creating pull requests. It also covers the workspace, operation history, interactive TUI, configuration, and AI agent setup.
Use this reference to work with Cargo, Rust’s package manager and build tool. It explains project manifests, dependencies, features, workspaces, build profiles, configuration, registries, publishing, and commands for building, testing, and inspecting projects.
Use this reference when building command-line applications with `spf13/cobra`. It shows how to organize commands, define flags, validate arguments, add lifecycle hooks, customize help output, provide shell completions, and connect flags with Viper configuration.