# kevwan/tproxy

A cli tool to proxy and analyze TCP connections.

Repository: https://github.com/kevwan/tproxy
Canonical: https://ross.abutalabs.com/products/tproxy
Homepage: https://go-zero.dev
Language: Go
License: MIT
License Family: permissive
Topics: monitoring-tool, tcp, tcpdump, grpc, proxy, relay, charles, connection, wireshark
Last push: 2026-07-09T08:12:43+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 39, longevity 100
- inputs: {"age_days": 1542, "days_push": 55, "days_rel": 251, "gap_med": 134.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3701, forks 253 (observed 2026-08-28T04:08:14.961586+00:00)

## What it is
tproxy is a Go CLI tool that proxies TCP connections while displaying and analyzing the traffic passing through them. It supports protocol-aware inspection for gRPC, HTTP/2, Redis, and MongoDB, plus packet delay and bandwidth throttling for testing.

## Use cases
- monitor gRPC connections and reconnection behavior
- inspect MySQL connection pool traffic
- debug TCP traffic between local services
- simulate network latency by delaying packets
- throttle bandwidth to test client behavior
- check TCP retransmission rate and RTT
- analyze redis or mongodb protocol traffic

## When to choose
- you need a lightweight CLI alternative to Charles or Wireshark for TCP debugging
- you want to observe connection lifecycle of gRPC or database clients
- you need to inject delay or speed limits into a TCP stream during testing

## When to avoid
- you need full HTTP request/response inspection with a GUI
- you need TLS-encrypted traffic decryption without keys
- you need packet-level capture rather than TCP stream proxying

## Facets
- artifact type: cli-tool
- maturity: active
- function: proxy, monitoring, networking, cli, developer-tools
- domain: networking, developer-tools, microservices
- platform: windows, cli, go
- tags: tcp-proxy, traffic-analysis, grpc-debugging, connection-monitoring, wireshark-alternative, charles-alternative, debugging, linux, macos, docker

## Member repositories
- kevwan/tproxy (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:14.961586+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:31:01.916902+00:00, confidence not recorded.
  - readme: https://github.com/kevwan/tproxy (fetched 2026-08-28T04:08:14.961586+00:00, sha 3db35dff8f2d)
  - homepage: https://go-zero.dev (fetched 2026-08-29T09:24:36.300798+00:00, sha 3244647fba16)
  - site_page: https://go-zero.dev/getting-started (fetched 2026-08-29T09:24:36.309918+00:00, sha 1b898bc4754f)
  - site_page: https://go-zero.dev/guides/quickstart/hello-world (fetched 2026-08-29T09:24:36.311866+00:00, sha c30801468e94)
- Data as of 2026-08-30T08:39:29.467469+00:00.