@gman-ai/dev

GMAN Developer SDK - A flight recorder for your AI agents.

Capture every API call your agents make to OpenAI, Anthropic, and other LLM providers. Debug sessions, track costs, and understand exactly what happened.

Installation

npm install -g @gman-ai/dev

Quick Start

1. Get an API Key

Sign in at getmyagentnow.com and create an API key in the Dev Cockpit.

2. Set Your API Key

export GMAN_API_KEY=gman_dev_sk_...

3. Start the Proxy

gman-dev start

This starts a local proxy on port 9000.

4. Point Your Agent

Configure your agent's base URL to use the GMAN proxy:

// OpenAI SDK
const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "http://localhost:9000/v1", // GMAN proxy
});

// Then use normally
const response = await openai.chat.completions.create({
  model: "gpt-4",
  messages: [{ role: "user", content: "Hello!" }],
});

5. View Sessions

Every request is captured and visible in your Dev Cockpit.

Commands

# Start proxy server (default port 9000)
gman-dev start

# Start on custom port
gman-dev start --port 8080

# Run demo (5 sample conversations)
gman-dev demo

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GMAN_API_KEY | Yes | Your GMAN developer API key | | OPENAI_API_KEY | For demo | OpenAI API key (demo only) | | GMAN_GATEWAY_URL | No | Gateway URL (default: production) |

How It Works

Your Agent → GMAN Proxy → OpenAI/Anthropic API
                ↓
         GMAN Gateway → Dashboard

The proxy intercepts LLM calls, forwards them to the provider, and sends telemetry to GMAN for observability.

Security & Data Handling

@gman-ai/dev runs a local proxy to observe AI agent requests for debugging and cost tracking.

What it does:

• Runs only on 127.0.0.1 (localhost)
• Proxies requests explicitly configured by the user
• Sends telemetry only while running
• Redacts authorization headers before sending telemetry
• Captures at most the first 1000 characters of request/response bodies

What it does not do:

• Does not run on install
• Does not capture traffic without explicit user action
• Does not read local files
• Does not collect environment variables
• Does not expose ports publicly

You should not use GMAN with sensitive production data unless you intend that data to be observed for debugging.

License

MIT