carapace

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 com

SKILL.md

GitHub

Carapace Usage Reference

Reference for using carapace shell completion — integrating into CLIs, writing specs, creating actions, and configuring completions.

Sub-Resources

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

Quick Guide

Cross-Project References

For internal library development (Action API internals, traverse engine, shell formatters, style system), use the carapace-dev skill (in the carapace repo).