Installation

Get the Releases CLI up and running.

Homebrew

On macOS and Linux with Homebrew:

brew install buildinternet/tap/releases

npm

Install globally via npm — prebuilt binaries for macOS and Linux are included:

npm install -g @buildinternet/releases

Or run without installing:

npx @buildinternet/releases search "react"

Shell script

Download and install the latest binary directly:

curl -fsSL https://releases.sh/install | bash

The script detects your platform, downloads the correct binary from npm, and installs it to /usr/local/bin. Set RELEASED_INSTALL_DIR to change the install location.

From source (development)

The CLI source lives at github.com/buildinternet/releases-cli. Requires Bun v1.1+.

git clone https://github.com/buildinternet/releases-cli.git
cd releases-cli
bun install
bun src/index.ts --help

Verify

After installing, verify the CLI is working:

releases --help

MCP server

To use Releases as an MCP tool server, the easiest path is the hosted remote server at https://mcp.releases.sh/mcp.

Codex:

codex mcp add releases --url https://mcp.releases.sh/mcp

Claude Code:

claude mcp add --transport http releases https://mcp.releases.sh/mcp

See the MCP Server docs for the general endpoint, client-specific setup, and stdio fallback configuration.

Telemetry

The CLI and local MCP server record anonymous usage events (command name, CLI version, OS/arch, exit code, duration) to help us understand what's used. No arguments, flag values, queries, or content are ever sent. Opt out any time:

releases telemetry disable              # persistent
RELEASED_TELEMETRY_DISABLED=1 releases … # per-invocation

See Privacy & Telemetry for the full list of what is and isn't collected.