# Install carapace with Homebrew, apk, MacPorts, Nix, winget Multi-shell multi-command argument completer. Version 1.7.3 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:carapace ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install carapace ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install carapace ``` Evidence: MacPorts ports tree: sysutils/carapace/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add carapace ``` Evidence: Alpine Linux edge package indexes: carapace from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#carapace ``` Evidence: nixpkgs package indexes: pkgs/by-name/ca/carapace/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - winget (92%): ```sh winget install --id rsteube.Carapace -e ``` Evidence: Windows Package Manager source index: rsteube.Carapace from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:carapace - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.7.3 - **Source summary:** Multi-shell multi-command argument completer - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-30T23:54:20Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - carapace (cli) - carapace (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.7.3 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://github.com/carapace-sh/carapace-bin - Upstream latest detected: v1.7.3 (current) ## Project history and usage carapace is a Go-based multi-shell argument completer distributed as the carapace-bin package. It exists in the long tradition of shell completion frameworks, but its package-nerd hook is that one completion engine can target many shells instead of requiring a separate completion script style for Bash, Zsh, Fish, PowerShell, Nushell, Xonsh, Elvish, and others. ### Project history The public carapace-bin repository was created on GitHub in April 2020. Its README describes the project as a multi-shell completion binary, and the repository topics show the project deliberately spans many shell ecosystems rather than being tied to a single command-line environment. The project grew around two related surfaces: a collection of completers for existing CLI tools and a specification system for adding custom completions. Its documentation is published as an mdBook site, and the README points users to install and setup pages rather than treating the GitHub README as the only manual. ### Adoption history The project is packaged across multiple operating-system package channels. The supplied Homebrew source facts list Homebrew, Alpine, MacPorts, Nix, and winget package mappings, while the upstream README includes a Repology packaging badge, signaling that distribution packaging is part of the project's public identity. Adoption has been strongest among users who move between shells or who want richer completion behavior without writing shell-specific scripts. The upstream README's supported-shell list includes both traditional shells and newer interactive shells, which is the core adoption story for carapace. ### How it is used Users install the carapace binary, enable it for their shell, and then use it to provide argument completions for supported commands. The upstream README links to the official install and setup documentation, and the official completers page documents the list of commands covered by the project. For package maintainers and power users, carapace is also interesting because completions can be specified outside a single shell's scripting language, making it useful when a command-line tool needs completions across several shell communities. ### Why package nerds care carapace matters to package nerds because shell completion is often the forgotten layer between a package and its users. A package that ships a good binary but poor completions feels worse in day-to-day terminal use, and carapace offers a shared completion layer that package managers can distribute like any other CLI tool. Its significance also comes from cross-shell normalization. Package repositories normally have to care about Bash, Zsh, Fish, PowerShell, and newer shells separately; carapace turns that messy edge of packaging into a dedicated, versioned tool. ### Timeline - 2020: carapace-bin repository created on GitHub. - 2022: GitHub releases page shows published carapace-bin release tags by at least v0.11.0. - 2026: GitHub repository metadata shows the project still active, with shell-completion topics and ongoing updates. ### Related projects - carapace is related to shell-native completion systems for Bash, Zsh, Fish, PowerShell, Nushell, Elvish, Xonsh, Oil, Tcsh, Ion, and Cmd, all of which are listed in the upstream README as supported or experimental shells. - It is also related to package-manager completion distribution: Homebrew, Alpine, MacPorts, Nix, and winget mappings in the supplied source facts show how the same completion binary reaches users through several ecosystems. ### Sources - - - - - source_facts.package-manager ## Security Notes generalized runtime or code generation signal. - **Geiger risk:** yellow / medium - generalized runtime or code generation signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ${UserConfigDir}/carapace, ${UserConfigDir}/carapace/specs, ${UserConfigDir}/carapace/variables/{group}.yaml, ${UserConfigDir}/carapace/bridge ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** carapace - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - carapace: normalized package name match | nixpkgs package indexes: pkgs/by-name/ca/carapace/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - carapace - 1.5.7-r5: normalized package name match | Alpine Linux edge package indexes: carapace from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Multi-shell multi-command argument completer | https://carapace.sh/ - MacPorts - carapace: normalized package name match | MacPorts ports tree: sysutils/carapace/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - winget - rsteube.Carapace: normalized package name match | Windows Package Manager source index: rsteube.Carapace from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [python-argcomplete](https://www.automicvault.com/pkg/brew/python-argcomplete/) - Shares av.db curated category or tags: cli, developer-tools, shell-completion. - [fzf](https://www.automicvault.com/pkg/brew/fzf/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, shell. - [jshon](https://www.automicvault.com/pkg/brew/jshon/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, shell. ## Combined YAML source View the package source record on GitHub. [combined/carapace.yml](https://github.com/automic-vault/db/blob/main/combined/carapace.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph