# Aai Posthog

> Use aai-cli to query PostHog product analytics, read projects, execute HogQL event queries, list saved insights, inspect persons and cohorts, read team dashboards, and view release annotations.

- Skill: `aai-labs/aai-posthog` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aai-labs/aai-posthog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aai-labs/aai-posthog/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: aai-labs (https://skillmd.com/u/aai-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aai-labs/aai-posthog

---


# aai-cli PostHog

Use this skill when working with PostHog product analytics through `aai-cli posthog`.

Before running commands, confirm the active profile or pass `--profile`, `--project-id`, or environment variables `POSTHOG_API_KEY`, `POSTHOG_PROJECT_ID`, and `POSTHOG_HOST`.

PostHog integration is read-first for product decision-making, idea discovery, and release impact correlation. Prefer typed subcommands for discovering projects, saved team insights, cohorts, dashboards, and annotations. For custom analytics, use `posthog events query` with HogQL queries or raw JSON query payloads.

List commands aggregate PostHog pagination up to `--limit` and preserve the provider response shape (`count`, `next`, `previous`, `results`).

Successful output is JSON on stdout. Errors are structured JSON on stderr. See [the command reference](references/command-reference.md) for command shapes, response notes, query examples, and output shapes captured from a PostHog workspace.