# carapace-sh/carapace

A multi-shell completion library.

Repository: https://github.com/carapace-sh/carapace
Canonical: https://ross.abutalabs.com/products/carapace
Homepage: https://carapace.sh
Language: Go
License: Apache-2.0
License Family: permissive
Topics: cobra, bash, elvish, powershell, zsh, completion, generator, xonsh, oil, fish, nushell, ion, tcsh, xontrib, carapace, shell
Last push: 2026-08-26T18:51:15+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 2360, "days_push": 7, "days_rel": 7, "gap_med": 12, "n_releases_24m": 48}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1427, forks 37 (observed 2026-08-28T04:04:41.685006+00:00)

## What it is
Carapace is a Go library and binary for generating command argument completions across many shells, including Bash, Zsh, Fish, PowerShell, Nushell, Elvish, Xonsh, and more. It integrates tightly with the Cobra CLI framework and also supports custom specs and bridging other completion frameworks.

## Use cases
- add tab completion to a cobra CLI for bash and zsh
- generate shell completions for multiple shells from one spec
- write custom completion specs for existing commands
- bridge completions from other frameworks
- add completions for nushell and elvish

## When to choose
- you build Go CLIs with cobra and want rich multi-shell completions
- you need one completion definition that works across many shells
- you want to add completions for commands you don't control via custom specs

## When to avoid
- your CLI is not written in Go and you don't want to ship a completion binary
- you only need a single shell and prefer that shell's native completion system
- you need Cmd, Ion, or Tcsh support, which are still experimental

## Facets
- artifact type: library
- maturity: active
- function: cli, developer-tools, plugin-system
- domain: developer-tools
- platform: windows, go, cli
- tags: shell-completion, cobra, bash, zsh, fish, nushell, powershell, elvish, xonsh, completion-generator, command-line, linux, macos

## Member repositories
- carapace-sh/carapace (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:41.685006+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:21.832462+00:00, confidence not recorded.
  - readme: https://github.com/carapace-sh/carapace (fetched 2026-08-28T04:04:41.685006+00:00, sha 7d61e028e491)
  - homepage: https://carapace.sh (fetched 2026-08-29T11:48:59.781868+00:00, sha 1bd3b6062681)
- Data as of 2026-08-30T08:39:29.467469+00:00.