# Install naga-cli with Homebrew, apt Shader translation command-line tool. Version 30.0.0 via Homebrew; verified 2026-07-01. Also installable with debian: sudo apt install libnaga-java. ## Install ```sh sudo av install brew:naga-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install naga-cli ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install libnaga-java ``` Evidence: Debian stable package indexes: libnaga-java from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz ## Package facts - **Package key:** brew:naga-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 30.0.0 - **Source summary:** Shader translation command-line tool - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 OR MIT - **Source archive:** - **Last updated:** 2026-07-01T21:39:00Z - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - naga (cli) - naga (alias) ## Build dependencies - 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-08-04 - Package-manager version: 30.0.0 - Package-manager updated: 2026-07-01 - Local data: ok - Upstream repository: https://wgpu.rs/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage naga-cli is the command-line frontend for Naga, the Rust shader translation and validation library used by the gfx-rs/wgpu stack. The package installs a `naga` binary, which is why the Homebrew formula conflicts with the unrelated Snake-game formula named `naga`. ### Project history Naga began as part of the gfx-rs graphics stack, with docs and maintainer writing tying it to an earlier Javelin name and to the WebGPU/WGSL transition. The old standalone gfx-rs/naga repository is archived because development moved into the wgpu repository, but the docs still describe Naga as a standalone library. The naga crate was created on crates.io on February 27, 2020; the naga-cli crate was created on October 20, 2021. ### Adoption history Naga adoption is mostly transitive through wgpu, not through direct CLI use. On July 1, 2026 the wgpu GitHub API showed 17,474 stars, 1,343 forks, and GitHub's rendered repository page showed it used by more than 46,000 dependents. crates.io reported 28,591,294 total downloads for the naga library crate and 43,842 for naga-cli. Homebrew reported 358 naga-cli installs over 365 days, which fits the CLI's role as a developer/debugging tool rather than the normal application dependency path. ### How it is used The CLI is used to validate shaders and exercise conversion paths: WGSL validation, SPIR-V dumps, SPIR-V to Metal, WGSL to GLSL under a selected profile, and output formats such as WGSL, GLSL, Metal, HLSL, SPIR-V, and DOT. Graphics developers use it when debugging shader portability, testing Naga behavior at a particular wgpu commit, checking snapshots, or reducing shader translation bugs outside a full application. ### Why package nerds care naga-cli is significant because it exposes one of the key moving parts behind Rust WebGPU portability. wgpu uses Naga to translate WGSL into platform shading languages for native backends, and maintainer writing describes Naga as powering wgpu and transitively Gecko/Firefox. For package nerds, the formula is also a classic binary-name collision case: `brew install naga-cli` and `brew install naga` cannot coexist because both provide `naga`. ### Timeline - 2018-09-13: wgpu repository created. - 2020-02-27: naga crate created on crates.io. - 2021-10-07: gfx-rs announced wgpu v0.11 and naga v0.7, describing naga as the shader translation and validation layer. - 2021-10-20: naga-cli crate created on crates.io. - 2026-05-02: wgpu/naga v29.0.3 published. - 2026-07-01: crates.io reported 28,591,294 naga downloads and 43,842 naga-cli downloads. ### Related projects - wgpu - WebGPU - WGSL - SPIR-V - Tint - Dawn - Gecko - Firefox ### Sources - - - - - - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** naga-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Conflicts With:** naga - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - libnaga-java - 3.0+svn80-5: installed executable or alias match | Debian stable package indexes: libnaga-java from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Simplified Java NIO asynchronous sockets | https://code.google.com/archive/p/naga/ - Ubuntu apt - libnaga-java - 3.0+svn80-5: installed executable or alias match | Ubuntu 24.04 LTS package indexes: libnaga-java from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Simplified Java NIO asynchronous sockets | https://code.google.com/archive/p/naga/ ## Related links - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Language runtime packages](https://pkg.so/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [rust](https://pkg.so/brew/rust/) - Build dependency declared by Homebrew. - [shaderc](https://pkg.so/brew/shaderc/) - Shares pkgdb curated category or tags: cli, developer-tools, graphics, spir-v. - [spirv-cross](https://pkg.so/brew/spirv-cross/) - Shares pkgdb curated category or tags: cli, developer-tools, shader-tools, spir-v. - [msdfgen](https://pkg.so/brew/msdfgen/) - Shares pkgdb curated category or tags: cli, developer-tools, graphics. - [t1lib](https://pkg.so/brew/t1lib/) - Shares pkgdb curated category or tags: cli, developer-tools, graphics. - [pixlet](https://pkg.so/brew/pixlet/) - Shares pkgdb curated category or tags: cli, developer-tools, graphics. - [uv](https://pkg.so/brew/uv/) - Shares pkgdb curated category or tags: cli, developer-tools, rust. - [ripgrep](https://pkg.so/brew/ripgrep/) - Shares pkgdb curated category or tags: cli, developer-tools, rust. - [starship](https://pkg.so/brew/starship/) - Shares pkgdb curated category or tags: cli, developer-tools, rust. - [cargo-edit](https://pkg.so/brew/cargo-edit/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, command-line, developer, developer-tools, line. ## Combined YAML source View the package source record on GitHub. [combined/naga-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/naga-cli.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph