aai-cli PostHog

SkillDatabases & data

Once added, your AI can answer product usage questions straight from your PostHog data, from raw event queries to saved insights and team dashboards. It can also look up individual persons and cohorts and check release annotations for context around changes.

Available today. Use it from your connected AI after setup.

After adding it, use aai-cli to give it access to your PostHog projects. Then start asking questions about events, insights, dashboards, or specific users.

Then ask your AI: use the aai-cli PostHog skill

What your AI can do with it

  • Query PostHog product analytics to answer usage questions
  • Run HogQL queries over raw event data
  • List saved insights and read team dashboards
  • Look up persons and cohorts to see who did what
  • View release annotations for context on changes
  • Read across your PostHog projects

What this skill tells your AI

The instructions your AI receives, as published by aai-labs/agent-barn in api/domains/agents/aai_cli_skills/bundled/skills/aai-posthog/SKILL.md and read by ahel’s review.

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 for command shapes, response notes, query examples, and output shapes captured from a PostHog workspace.

Signals

GitHub stars
85
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
aai-posthog
Source
github.com/aai-labs/agent-barn