# Install cargo-bundle with Homebrew, Nix

Wrap rust executables in OS-specific app bundles. Version 0.11.0 via Homebrew; verified 2026-05-31.

## Install

```sh
sudo av install brew:cargo-bundle
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install cargo-bundle
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#cargo-bundle
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ca/cargo-bundle/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:cargo-bundle
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/cargo-bundle>
- **Version:** 0.11.0
- **Source summary:** Wrap rust executables in OS-specific app bundles
- **Homepage:** <https://github.com/burtonageo/cargo-bundle>
- **Repository:** <https://github.com/burtonageo/cargo-bundle>
- **Upstream docs:** <https://github.com/burtonageo/cargo-bundle#readme>
- **License:** Apache-2.0 OR MIT
- **Source archive:** <https://github.com/burtonageo/cargo-bundle/archive/refs/tags/v0.11.0.tar.gz>
- **Last updated:** 2026-05-31T10:36:43Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- cargo-bundle (cli)
- cargo-bundle (alias)

## Build dependencies

- pkgconf
- rust

## 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: 0.11.0
- Package-manager updated: 2026-05-31
- Local data: ok
- Upstream repository: https://github.com/burtonageo/cargo-bundle
- Upstream latest detected: v0.11.0 (current)
## Project history and usage

cargo-bundle is a Cargo subcommand for wrapping Rust GUI executables into operating-system application bundles and installer formats.

### Project history

The cargo-bundle repository was created in January 2016 and the first crates.io release followed in March 2016. The README positions it as a tool for generating macOS app bundles, iOS bundles, Debian packages, and experimental Windows MSI installers from Cargo-built executables.

Its design centers on a `[package.metadata.bundle]` section in Cargo.toml. That metadata describes user-facing application attributes such as name, identifier, icon, version, resources, copyright, category, descriptions, Debian dependencies, macOS frameworks, and URL schemes.

### Adoption history

cargo-bundle occupies a narrower niche than compiler or profiling Cargo plugins: desktop and GUI Rust applications. Crates.io reports more than 150,000 downloads, and the input records Homebrew and Nix packaging.

The project remained useful because early Rust desktop applications needed a Cargo-native way to bridge from a compiled binary to platform packaging conventions without adopting a full application framework.

### How it is used

Users install it with `cargo install cargo-bundle`, add `[package.metadata.bundle]` to Cargo.toml, and run `cargo bundle` from the package directory. The command supports familiar Cargo selectors and build controls such as `--bin`, `--example`, `--release`, `--profile`, `--target`, and feature flags.

The README documents output formats including deb, ios, msi, wxsmsi, osx, rpm, and appimage, while also warning that the project status is early alpha and that the metadata format is not guaranteed stable.

### Why package nerds care

cargo-bundle is historically interesting because it embeds desktop packaging metadata inside Cargo.toml rather than treating app bundling as an entirely external release step. It shows how Rust package metadata became a place for downstream packaging intent, not just dependency resolution.

For package maintainers, it connects Rust crates to platform-native artifacts such as `.app`, `.deb`, and `.msi`, making it a small but useful example of Cargo crossing from language package manager into OS package production.

### Timeline

- 2016-01-10: GitHub repository burtonageo/cargo-bundle was created.
- 2016-03-22: cargo-bundle 0.0.0 was published on crates.io.
- 2016 onward: README documented `[package.metadata.bundle]` as the Cargo.toml integration point for bundle metadata.
- 2026-05-30: Version 0.11.0 was published.

### Related projects

- Cargo provides the build and subcommand interface cargo-bundle extends.
- Platform packaging formats documented by the project include macOS app bundles, Debian packages, Windows MSI installers, RPM packages, and AppImage.
- The Rust desktop packaging space overlaps conceptually with later application-packaging frameworks, but cargo-bundle remains a small Cargo-native bundling tool.

### Sources

- GitHub repository API metadata: https://api.github.com/repos/burtonageo/cargo-bundle
- Official README: https://github.com/burtonageo/cargo-bundle#readme
- Package-manager adoption from source_facts.package-manager.
- crates.io API metadata and versions: https://crates.io/api/v1/crates/cargo-bundle


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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: Cargo.toml
- Windows: Cargo.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** cargo-bundle
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - cargo-bundle: normalized package name match | nixpkgs package indexes: pkgs/by-name/ca/cargo-bundle/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family.
- [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.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [cargo-auditable](https://www.automicvault.com/pkg/brew/cargo-auditable/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-binstall](https://www.automicvault.com/pkg/brew/cargo-binstall/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-binutils](https://www.automicvault.com/pkg/brew/cargo-binutils/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-bloat](https://www.automicvault.com/pkg/brew/cargo-bloat/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-c](https://www.automicvault.com/pkg/brew/cargo-c/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-cache](https://www.automicvault.com/pkg/brew/cargo-cache/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-careful](https://www.automicvault.com/pkg/brew/cargo-careful/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-chef](https://www.automicvault.com/pkg/brew/cargo-chef/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.

## Combined YAML source

View the package source record on GitHub. [combined/cargo-bundle.yml](https://github.com/automic-vault/db/blob/main/combined/cargo-bundle.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
