# Install tproxy with Homebrew, Nix, scoop

CLI tool to proxy and analyze TCP connections. Version 0.9.2 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:tproxy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tproxy
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tproxy
```

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

### Windows

- Scoop (92%):

```sh
scoop install main/tproxy
```

  Evidence: Scoop official bucket manifest trees: bucket/tproxy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:tproxy
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tproxy>
- **Version:** 0.9.2
- **Source summary:** CLI tool to proxy and analyze TCP connections
- **Homepage:** <https://go-zero.dev>
- **Repository:** <https://github.com/kevwan/tproxy>
- **Upstream docs:** <https://github.com/kevwan/tproxy#readme>
- **License:** MIT
- **Source archive:** <https://github.com/kevwan/tproxy/archive/refs/tags/v0.9.2.tar.gz>
- **Last updated:** 2026-06-15T10:21:22-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- tproxy (cli)
- tproxy (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: 0.9.2
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/kevwan/tproxy
- Upstream latest detected: v0.9.2 (current)
## Project history and usage

tproxy is a Go CLI for proxying and analyzing TCP connections, aimed at developers who need to observe live service traffic without setting up a full packet-analysis stack.

### Project history

The upstream README frames tproxy as a tool written out of backend-service development needs. The author says that while developing backend services and go-zero, they often needed to monitor network traffic such as gRPC connection behavior, MySQL connection pools, and arbitrary TCP connections.

The GitHub repository was created in June 2022 and released v0.1.0 the same day. Release metadata shows a steady 0.x series continuing through v0.9.2 in December 2025.

### Adoption history

The project is distributed through Go's normal `go install` workflow and through Docker images; the README also documents Windows installation with Scoop. The batch source facts show additional packaging in Homebrew and Nix, which puts the tool in the cross-platform package-manager niche rather than only in the Go module ecosystem.

### How it is used

Users run tproxy as a local listener that forwards to a remote address, optionally selecting protocol handling for http2, grpc, redis, or mongodb, adding packet delay, limiting upload or download speed, and enabling statistics. Official examples cover monitoring gRPC traffic, MySQL connections, reliability through retransmission and RTT statistics, and connection-pool behavior.

### Why package nerds care

tproxy appeals to package nerds because it sits between heavyweight packet tools and application observability stacks: it is a single CLI that can be installed by Homebrew, Nix, Scoop, Go, or Docker and used immediately in local debugging sessions.

### Timeline

- 2022-06: GitHub repository created and v0.1.0 released.
- 2022-07: v0.5.0 released during the early rapid-release period.
- 2023-02: v0.7.0 released.
- 2025-12: v0.9.2 released.

### Related projects

- go-zero, gRPC, MySQL, Redis, MongoDB, Wireshark, Charles, tcpdump.

### Sources

- <https://api.github.com/repos/kevwan/tproxy>
- <https://github.com/kevwan/tproxy#readme>
- <https://github.com/kevwan/tproxy/releases>
- source_facts.package-manager


## 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:** tproxy
- **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 - tproxy: normalized package name match | nixpkgs package indexes: pkgs/by-name/tp/tproxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Scoop - main/tproxy: normalized package name match | Scoop official bucket manifest trees: bucket/tproxy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://www.automicvault.com/pkg/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [goctl](https://www.automicvault.com/pkg/brew/goctl/) - Shares the same upstream homepage.
- [proxytunnel](https://www.automicvault.com/pkg/brew/proxytunnel/) - Shares av.db curated category or tags: cli, networking, proxy, tcp.
- [redir](https://www.automicvault.com/pkg/brew/redir/) - Shares av.db curated category or tags: cli, networking, proxy, tcp.
- [rinetd](https://www.automicvault.com/pkg/brew/rinetd/) - Shares av.db curated category or tags: cli, networking, proxy, tcp.
- [stone](https://www.automicvault.com/pkg/brew/stone/) - Shares av.db curated category or tags: cli, networking, proxy, tcp.
- [brook](https://www.automicvault.com/pkg/brew/brook/) - Shares av.db curated category or tags: cli, networking, proxy.
- [cntlm](https://www.automicvault.com/pkg/brew/cntlm/) - Shares av.db curated category or tags: cli, networking, proxy.
- [connect](https://www.automicvault.com/pkg/brew/connect/) - Shares av.db curated category or tags: cli, networking, proxy.
- [ctrld](https://www.automicvault.com/pkg/brew/ctrld/) - Shares av.db curated category or tags: cli, networking, proxy.
- [tcpstat](https://www.automicvault.com/pkg/brew/tcpstat/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, connections, monitoring, network, network-monitoring.
- [miruo](https://www.automicvault.com/pkg/brew/miruo/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, monitoring, network, network-monitoring, networking.
- [netshow](https://www.automicvault.com/pkg/brew/netshow/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, monitoring, network, network-monitoring, networking.

## Combined YAML source

View the package source record on GitHub. [combined/tproxy.yml](https://github.com/automic-vault/db/blob/main/combined/tproxy.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
- external package-manager database matches
- cross-ecosystem install command graph
