ProxAI Gateway

ProxAI Gateway is the open-source application that brings your coding-agent activity into ProxAI. It runs on your machine, reads Claude Code, Cursor, Codex, and Claude Desktop session files directly from disk — no proxy, no traffic interception — and redacts API keys and other secrets locally before anything is uploaded. The entire source code is public at github.com/proxai/proxai_gateway , so you can audit exactly what it does.

Onboarding takes a couple of minutes: generate a key, install the binary, run setup, and confirm with status.

1. Generate a Gateway Key

The gateway authenticates with a dedicated Gateway Ingestion Key minted from the ProxAI dashboard:

1. Sign in at proxai.co  and open your organization’s Overview page — the onboarding section there walks through these same steps and generates the key for you.
2. Alternatively, create an ingestion key directly from the API Keys  page.
3. Copy the key — you’ll pass it to setup in step 3.

2. Install the Gateway

ProxAI Gateway ships as a single self-contained binary — you don’t need Bun, Node, or any other runtime to run it. It installs to a user-writable location, so no sudo and no admin prompt.

macOS / Linux

curl -fsSL https://github.com/proxai/proxai_gateway/raw/main/install.sh | bash

Windows (PowerShell)

irm https://github.com/proxai/proxai_gateway/raw/main/install.ps1 | iex

npm — any platform, requires Node 18+

npm install -g @proxai/gateway

3. Run Setup

Configure the gateway with the key you generated:

proxai-gateway setup <your-gateway-key>

You can also run proxai-gateway setup with no argument to be prompted for the key. Setup verifies the key with ProxAI, writes the local configuration, registers the gateway as a background service that launches on login, and starts the daemon. From this point the gateway runs on its own — there is nothing to keep open and nothing else to configure.

4. Verify

proxai-gateway status

The status screen shows a health indicator, per-agent capture counts, and recent upload activity. It refreshes live; press q to quit. If you started from the organization Overview page, the Check Status button there confirms the same connection from the dashboard side.

That’s it — the gateway now captures activity from your coding agents and your sessions start appearing in the ProxAI dashboard.

Next Steps