# 使用 Homebrew, Nix, pacman 安装 usage

查看 usage 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:usage
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install usage
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#usage
```

  证据: nixpkgs package indexes: pkgs/by-name/us/usage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S usage
```

  证据: Arch Linux sync databases: usage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## 软件包事实

- **软件包键:** brew:usage
- **软件包管理器:** Homebrew
- **版本:** 4.1.0
- **来源摘要:** Tool for working with usage-spec CLIs
- **主页:** <https://usage.jdx.dev/>
- **仓库:** <https://github.com/jdx/usage>
- **最后更新:** 2026-07-30T13:39:00Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- usage (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.1.0
## 项目历史与用法

usage is both a specification and a CLI for describing command-line interfaces. The official README compares a Usage spec to OpenAPI for CLIs, covering arguments, flags, environment variables, and config files so downstream tools can generate completions, documentation, man pages, parsers, SDKs, and framework scaffolding.

### 项目历史

The project grew out of the modern CLI tooling ecosystem around jdx's tools and the KDL document language. Public GitHub releases show early v0.1.x releases in 2024 and v3.x releases in 2026, while the docs describe an expanding scope from shell completions and man pages toward type-safe SDK generation.

### 采用历史

The official CLI docs list installation through mise, Cargo, Homebrew, and Arch Linux. The input metadata also records Homebrew, Nix, and pacman package names, indicating adoption by users who want the same CLI-spec tool available across developer workstations and Linux distributions.

### 使用方式

A Usage spec is written in KDL and can describe a CLI's name, binary, about text, version, author, license, flags, arguments, subcommands, config files, environment variables, and defaults. The `usage` CLI then consumes that spec to generate shell completions, Markdown, man pages, JSON, and related artifacts.

### 为什么软件包爱好者会关心

Package nerds care about usage because it treats CLI metadata as a portable build artifact. Instead of each package separately hand-maintaining completions, man pages, and docs, maintainers can ship a spec and generate those outputs consistently.

### 时间线

- 2024: Early v0.1.x GitHub releases published.
- 2026-06-23: GitHub release v3.5.3 published.

### Related projects

- The official docs relate Usage to OpenAPI for CLIs, KDL as the spec language, and integrations for CLI frameworks such as clap, Cobra, Click, Typer, yargs, oclif, and Commander.js.

### 来源

- <https://github.com/jdx/usage>
- <https://github.com/jdx/usage/releases>
- <https://usage.jdx.dev/cli/>
- <https://usage.jdx.dev/spec>
- input source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 其他软件包管理器记录

- Nix - usage: normalized package name match | nixpkgs package indexes: pkgs/by-name/us/usage/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - usage - 3.5.5-1: normalized package name match | Arch Linux sync databases: usage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A specification for CLIs | https://github.com/jdx/usage


## Combined YAML source

View the package source record on GitHub. [combined/usage.yml](https://github.com/mxcl/pkgdb/blob/main/combined/usage.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph