# Install twitch-cli with Homebrew, Nix, winget, chocolatey

CLI to make developing on Twitch easier. Version 1.1.25 via Homebrew; verified 2026-04-25.

## Install

```sh
sudo av install brew:twitch-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install twitch-cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#twitch-cli
```

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

### Windows

- winget (92%):

```sh
winget install --id Twitch.TwitchCLI -e
```

  Evidence: Windows Package Manager source index: Twitch.TwitchCLI from https://cdn.winget.microsoft.com/cache/source.msix

- Chocolatey (92%):

```sh
choco install twitch
```

  Evidence: Chocolatey community package catalog: twitch from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','timberwinr'

## Package facts

- **Package key:** brew:twitch-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/twitch-cli>
- **Version:** 1.1.25
- **Source summary:** CLI to make developing on Twitch easier
- **Homepage:** <https://github.com/twitchdev/twitch-cli>
- **Repository:** <https://github.com/twitchdev/twitch-cli>
- **Upstream docs:** <https://dev.twitch.tv/docs/cli>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/twitchdev/twitch-cli/archive/refs/tags/v1.1.25.tar.gz>
- **Last updated:** 2026-04-25T05:08:13Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- twitch (cli)
- twitch (alias)

## Build dependencies

- go

## 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: 1.1.25
- Package-manager updated: 2026-04-25
- Local data: ok
- Upstream repository: https://github.com/twitchdev/twitch-cli
- Upstream latest detected: v1.1.25 (current)
## Project history and usage

Twitch CLI is Twitch's official command-line tool for Twitch developer workflows. It packages API calls, OAuth token generation, mock API data, and EventSub testing into a single `twitch` executable.

### Project history

Twitch announced the CLI on 2020-12-17 after Developer Day, alongside EventSub. The initial rationale was practical: developers needed a supported way to test webhook/EventSub migrations locally, generate tokens, and query Twitch APIs without building staging servers or relying on extra tunneling tools.

From the start, Twitch framed the CLI as a Twitch-supported open-source project on GitHub, intended to accept community contributions and grow into additional EventSub and developer-product support. The current official docs describe installation through Homebrew on macOS/Linux, Scoop on Windows, and manual release downloads.

### Adoption history

The CLI's adoption is tied to Twitch's developer ecosystem rather than general-purpose programming. Twitch's own community resources list it as the official CLI, created by Twitch and contributors, for testing API calls, mock APIs, EventSub WebSocket servers, and mock EventSub payloads.

Package-manager adoption follows that developer support path: Homebrew and Scoop are documented by Twitch as installation methods, while the input facts also show availability through Nix and Windows package channels.

### How it is used

Typical use starts with `twitch configure`, which stores a client ID and client secret in the default config file, then uses commands such as `twitch token`, `twitch api`, `twitch mock-api`, and `twitch event`.

For local development, users generate mock data with `twitch mock-api generate`, start a mock server on localhost, trigger webhook events, and test EventSub WebSocket client behavior including subscriptions, reconnects, close messages, and status changes.

### Why package nerds care

Twitch CLI is significant to package nerds because it turns a vendor API platform into a locally scriptable test harness. It is not just a convenience wrapper around HTTP calls; it also packages mock state, OAuth token flows, webhook signing behavior, and EventSub simulations.

Its official Homebrew and Scoop instructions show the package-manager role clearly: Twitch wanted developers to install and update the tool through familiar package workflows instead of copying binaries by hand.

### Timeline

- 2020-12-17: Twitch announces the official Twitch CLI in open beta.
- 2021: Official docs show mock API generation examples and local server workflows.
- 2020s: Official docs list Homebrew, Scoop, and manual releases as supported installation paths.
- 2020s: Twitch documents EventSub WebSocket simulation and mock subscription endpoints in the CLI.

### Related projects

- Twitch EventSub is the main API product that motivated the CLI's event-testing features.
- Twitch Developer Day introduced the products around which the CLI was announced.
- Homebrew, Scoop, and the twitchdev GitHub organization are the main packaging and source distribution channels.

### Sources

- Official Twitch CLI docs: https://dev.twitch.tv/docs/cli/
- Official WebSocket EventSub testing docs: https://dev.twitch.tv/docs/cli/websocket-event-command
- Official mock API docs: https://dev.twitch.tv/docs/cli/mock-api-command
- Twitch announcement blog: https://blog.twitch.tv/en/2020/12/17/introducing-the-twitch-command-line-interface-tool/
- Twitch community resources: https://dev.twitch.tv/code/


## 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: ~/.twitch-cli/.twitch-cli.env

## Credential files

- Unix: ~/.twitch-cli/.twitch-cli.env
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** twitch-cli
- **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 - twitch-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/tw/twitch-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - Twitch.TwitchCLI: normalized package name match | Windows Package Manager source index: Twitch.TwitchCLI from https://cdn.winget.microsoft.com/cache/source.msix
- Chocolatey - twitch: installed executable or alias match | Chocolatey community package catalog: twitch from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','timberwinr'


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control 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.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [oauth2c](https://www.automicvault.com/pkg/brew/oauth2c/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [oauth2l](https://www.automicvault.com/pkg/brew/oauth2l/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [graphql-cli](https://www.automicvault.com/pkg/brew/graphql-cli/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [grpcui](https://www.automicvault.com/pkg/brew/grpcui/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [grpcurl](https://www.automicvault.com/pkg/brew/grpcurl/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [algolia](https://www.automicvault.com/pkg/brew/algolia/) - Shares av.db curated category or tags: api, cli, developer-tools.
- [apfel](https://www.automicvault.com/pkg/brew/apfel/) - Shares av.db curated category or tags: api, cli, developer-tools.
- [api-linter](https://www.automicvault.com/pkg/brew/api-linter/) - Shares av.db curated category or tags: api, cli, developer-tools.
- [apib2swagger](https://www.automicvault.com/pkg/npm/apib2swagger/) - Local package facts share a topical domain. Shared terms: api, api-tools, cli, developer, developer-tools.

## Combined YAML source

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