# Install tproxy with Homebrew, Nix, scoop

CLI tool to proxy and analyze TCP connections. Version 0.9.2 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#tproxy.

## 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
- **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>
- **Last updated:** 2026-07-26T00:51:26+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- tproxy (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.9.2
## 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

## 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


## Combined YAML source

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


## Sources

- 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