gman — ai agent observability
multi-tenant platform · npm SDK · live in developer preview
GMAN watches AI agents in production and captures what they send, how much they cost, and how long they took. One local SDK proxy, one multi-tenant gateway, one per-tenant cockpit. The hardest part of the product is operational — how do you make LLM traces legible to the engineer at 2am without leaking one tenant's prompts into another's dashboard.
● operational ┊ trust boundary — measured: 47 route handlers · 23 migrations · gateway p50 ≈ 293 ms · 414 dev_events live
social-agent traces are visible here →
Snapshot from getmyagentnow.com/demo. The demo tenant is real — every session you see on the live page is the autonomous social agent scoring commits and drafting tweets, with each LLM call proxied through the GMAN SDK.
$ npm install @gman-ai/dev$ export GMAN_API_KEY="sk_live_..."import { spawn } from "child_process";
// Start the GMAN proxy once — it listens on localhost:9000
// and forwards to the upstream LLM provider, emitting telemetry
// to the GMAN gateway on every request.
const proxy = spawn("npx", ["@gman-ai/dev", "start"]);
process.env.OPENAI_BASE_URL = "http://localhost:9000/v1";
// Now any LLM SDK that respects OPENAI_BASE_URL is traced.
// Every call appears in cockpit under your tenant in seconds.The SDK is a local HTTP proxy, not a wrapper library. It works with any LLM client that respects OPENAI_BASE_URL, across languages, without modifying the agent code path.
| feature | status | notes |
|---|---|---|
| @gman-ai/dev SDK | [SHIPPED] | v0.1.8 on npm · local proxy · 9 releases |
| Multi-tenant gateway | [SHIPPED] | tenant_id derived server-side from API key hash |
| Session viewer / cockpit | [SHIPPED] | Clerk auth · per-tenant isolation |
| API key management | [SHIPPED] | create, rotate, revoke · hashed storage |
| Stripe Connect billing | [SHIPPED] | webhook-driven · multi-account payout ready |
| Public demo endpoint (/demo) | [SHIPPED] | sanitized reads · paranoid redaction at output layer |
| Policy · Evidence · Payout · Sidecar | [DESIGNED · FROZEN] | specs and schemas exist · frozen pending R2 |
- Public trace viewer beyond /demo (per-agent, per-session links)
- Cost calculator with per-model pricing
- SDK docs site (autogenerated from source)
The frozen designs are real — specs, schemas, migration paths. R1.5 is scoped to the observability core.