@agentcamo/cli

Residential proxy sessions for AI agents via x402 micropayments. One command — session created, timer running, traffic routing, geo-swap inline.

npx @agentcamo/cli --mode residential --chain solana --country us

How It Works

1. CLI pays 0.01 USDC via x402 (Base or Solana) to create a proxy session
2. You get a proxy URL — set HTTPS_PROXY and route traffic through a residential IP
3. Type a country code mid-session to geo-swap without interrupting your connection

Install

# Run directly (no install)
npx @agentcamo/cli

# Or install globally
npm install -g @agentcamo/cli

Requires Node.js 20+.

Usage

npx @agentcamo/cli [options]

Options:
  --mode        residential | mobile | socks5 | wireguard  [default: residential]
  --chain       base | solana                               [auto-detect from env]
  --country     ISO 3166-1 alpha-2 code                    [default: us]
  --json        Machine-readable JSONL output              [default: false]
  --verbose     Show full response bodies                  [default: false]
  -v, --version Show version
  -h, --help    Show help

Environment:
  AGENT_PRIVATE_KEY      EVM private key (hex, for --chain base)
  SOLANA_PRIVATE_KEY     Solana private key (base58, for --chain solana)

Modes

Residential (default)

HTTP forward proxy through residential IPs. Set HTTPS_PROXY and go.

npx @agentcamo/cli --mode residential --country us

Mobile / 5G

Same interface as residential, but exits through mobile carrier IPs (T-Mobile, Verizon, etc.). Better for bypassing bot detection.

npx @agentcamo/cli --mode mobile --country us

SOCKS5

RFC 1928/1929 SOCKS5 proxy. Use socks5h:// URL for DNS-over-proxy.

npx @agentcamo/cli --mode socks5 --country us

WireGuard

Full-tunnel VPN via Docker sidecar. Starts agentcamo/wg-sidecar container, exposes socks5h://localhost:1080. Requires Docker.

npx @agentcamo/cli --mode wireguard --country us

TUI

Interactive mode shows a live session dashboard:

AGENT CAMO — RESIDENTIAL

  Session: 7f8b5984...  Country: US  Exit IP: 95.135.22.185
  TTL 4:32  ████████████████░░░░  Mode: RESIDENTIAL

  > _                              ← type country code to geo-swap

Type a 2-letter country code (e.g. de) and press Enter to geo-swap mid-session.

Agent Mode (--json)

For autonomous agents — structured JSONL to stdout, no TUI:

npx @agentcamo/cli --mode residential --chain solana --country us --json

{"event":"session_created","sessionId":"7f8b...","country":"us","mode":"residential","exitIp":"95.135.22.185","expiresAt":"...","proxyUrl":"https://7f8b:[email protected]:8080"}
{"event":"ip_verified","exitIp":"95.135.22.185"}
{"event":"session_expiring","ttl_remaining":30}
{"event":"session_expired"}

Parse proxyUrl from the first line and route traffic immediately.

Pricing

| Mode | Cost | | ----------- | --------- | | Residential | 0.01 USDC | | Mobile / 5G | 0.01 USDC | | SOCKS5 | 0.01 USDC | | WireGuard | 0.05 USDC |

Paid via x402 on Base (EVM) or Solana mainnet. Session TTL: 5 minutes (default), configurable 1-30 min.

Docs

Full documentation at agentcamo.xyz.

License

MIT