agent-posthog

Named investigations — investigate user, investigate event and investigate flag return a worked answer rather than a pile of endpoint output

HogQL first-class — write and run queries directly, with async query submission you can wait on or cancel

Schema discovery — event definitions and property definitions, searchable, so a query can be written against what actually exists

The full read surface — persons, events, feature flags, dashboards, insights, session recordings and experiments

Keychain-first credentials — personal API keys are never printed back

LLM-safe setup — auth add --form opens a native OS dialog and returns only a redacted receipt

Sensible scoping — a profile carries host plus default org, project and environment; environment defaults to the project, so most setups only ever set --project

Multi-id gets do not lose the batch — an unresolvable id becomes an @unresolved line with exit 0; only command-level failures exit non-zero

Structured errors — fixable_by, a hint, and retry_after_seconds when PostHog rate-limits you

Raw API escape hatch for anything not yet wrapped

Mock server — mockposthog gives deterministic E2E fixtures, including invalid keys, missing scopes, rate limits and ambiguous flags

Single compiled Go binary — no runtime dependencies