# Install cargo-instruments with Homebrew

Easily generate Instruments traces for your rust crate. Version 0.4.17 via Homebrew; verified 2026-06-22.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install cargo-instruments
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:cargo-instruments
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/cargo-instruments>
- **Version:** 0.4.17
- **Source summary:** Easily generate Instruments traces for your rust crate
- **Homepage:** <https://github.com/cmyr/cargo-instruments>
- **Repository:** <https://github.com/cmyr/cargo-instruments>
- **Upstream docs:** <https://github.com/cmyr/cargo-instruments#readme>
- **License:** MIT
- **Source archive:** <https://github.com/cmyr/cargo-instruments/archive/refs/tags/v0.4.17.tar.gz>
- **Last updated:** 2026-06-22T14:02:58-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- cargo-instruments (cli)
- cargo-instruments (alias)

## Dependencies

- openssl@4

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.4.17
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/cmyr/cargo-instruments
- Upstream latest detected: v0.4.17 (current)
## Project history and usage

cargo-instruments is a Cargo subcommand for profiling Rust binaries with Apple's Xcode Instruments. Its README describes it as glue between Cargo and Xcode's profiling suite, producing trace files that can be opened in Instruments.app.

### Project history

The crate first appeared on crates.io in March 2019 and remains a macOS-focused tool: the official README says it requires macOS because it uses Instruments, selecting either the older instruments command or xcrun xctrace depending on the macOS version.

### Adoption history

Homebrew packages cargo-instruments as a formula, and the official README presents brew install cargo-instruments as the simplest installation path. Crates.io metadata reported 47,159 downloads and version 0.4.17 when checked on 2026-06-30.

### How it is used

Users run cargo instruments against a package binary, example, or benchmark target, choose an Instruments template such as Allocations or Time Profiler, and inspect the generated .trace output under target/instruments or another requested path.

### Why package nerds care

It is a niche but useful bridge between the Rust package workflow and Apple's native profiler, notable because it exposes Instruments through a cargo subcommand instead of requiring users to manually stage and launch binaries.

### Timeline

- 2019: First crates.io release 0.1.0.
- 2026: Crates.io latest version 0.4.17 and Homebrew stable version 0.4.17.

### Related projects

- Related tooling includes Cargo itself and Xcode Instruments; cargo-instruments delegates profiling to Apple's Instruments/xctrace tooling.

### Sources

- <https://api.github.com/repos/cmyr/cargo-instruments>
- <https://github.com/cmyr/cargo-instruments>
- <https://github.com/cmyr/cargo-instruments#readme>
- <https://crates.io/api/v1/crates/cargo-instruments>
- <https://formulae.brew.sh/api/formula/cargo-instruments.json>


## Security Notes

No matching local secret-handling manifest was found for cargo-instruments. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

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


## 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.
- [openssl@4](https://www.automicvault.com/pkg/brew/openssl-4/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [cargo-bloat](https://www.automicvault.com/pkg/brew/cargo-bloat/) - Shares av.db curated category or tags: cargo, cli, developer-tools, profiling, rust.
- [cargo-careful](https://www.automicvault.com/pkg/brew/cargo-careful/) - Shares av.db curated category or tags: cargo, cli, debugging, developer-tools, rust.
- [cargo-flamegraph](https://www.automicvault.com/pkg/brew/cargo-flamegraph/) - Shares av.db curated category or tags: cargo, cli, developer-tools, profiling, rust.
- [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-bundle](https://www.automicvault.com/pkg/brew/cargo-bundle/) - 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-clone](https://www.automicvault.com/pkg/brew/cargo-clone/) - Both packages touch the same language runtime or ecosystem. Shared terms: cargo, cli, crate, developer, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/cargo-instruments.yml](https://github.com/automic-vault/db/blob/main/combined/cargo-instruments.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
