Pp Posthog

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/developer-tools/posthog/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

PostHog — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the posthog-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install posthog --cli-only

2. Verify: posthog-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/developer-tools/posthog/cmd/posthog-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use posthog-pp-cli when an agent task requires querying, diffing, or combining PostHog data across more than one resource type — flag state vs error events, LLM costs vs variant performance, experiment exposure vs significance. It is faster than the web UI for bulk reads and produces structured JSON that agents can consume directly without parsing HTML.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Flag safety

• flags blast-radius — Find every insight, dashboard, experiment, and survey that references a flag before you archive or rename it.

  Use before archiving or renaming a flag to prevent breaking dashboards and experiments silently.

  posthog-pp-cli flags blast-radius --key my-checkout-v2 --json

• flags rollout-health — Go/no-go confidence for a flag ramp — error rate and key metric movement correlated with flag exposure.

  Use before ramping a flag to 100% to catch regressions that aren't visible in overall metrics.

  posthog-pp-cli flags rollout-health --key new-checkout --window 24h --agent

• flags stale — List flags that haven't been evaluated in N days — cleanup candidates before they accumulate.

  Use in quarterly flag cleanup sprints to identify dead code paths safely.

  posthog-pp-cli flags stale --days 30 --json

LLM observability

• llm cost-attribution — Break down LLM spend by feature flag variant — see whether the expensive model variant pays for itself.

  Use when evaluating whether to promote a more expensive LLM variant based on actual cost-per-conversion.

  posthog-pp-cli llm cost-attribution --flag model-tier --agent

Local state that compounds

• persons at-risk — Surface which users in a cohort are going quiet and recently hit errors — before they churn.

  Use in weekly retention reviews to prioritize proactive outreach before churn events.

  posthog-pp-cli persons at-risk --cohort paying-users --silent-days 14 --json

• events property-drift — Catch tracking regressions — properties that silently disappeared from an event between two time windows.

  Use after a deploy to catch silent schema changes that corrupt ongoing experiments and dashboards.

  posthog-pp-cli events property-drift checkout_completed --agent

• experiments pre-check — Know today whether an experiment will reach significance this sprint, or needs traffic adjustment now.

  Use at the start of each sprint to surface experiments that need traffic changes before they run out of time.

  posthog-pp-cli experiments pre-check --agent

• dashboard health — Find broken dashboards before a stakeholder meeting does — stale data, deleted cohorts, archived flags.

  Use before weekly business reviews to catch broken insight tiles that would embarrass the data team.

  posthog-pp-cli dashboard health --stale-days 7 --agent

Command Reference

projects — Manage projects

public-hog-function-templates — Manage public hog function templates

• posthog-pp-cli public-hog-function-templates — List

user-home-settings — Manage user home settings

• posthog-pp-cli user-home-settings partial-update — Update the authenticated user's pinned sidebar tabs and/or homepage for the current team. Pass @me as the UUID....
• posthog-pp-cli user-home-settings retrieve — Get the authenticated user's pinned sidebar tabs and configured homepage for the current team. Pass @me as the UUID.

users — Manage users

• posthog-pp-cli users cancel-email-change-request-partial-update — Cancel email change request partial update
• posthog-pp-cli users destroy — Destroy
• posthog-pp-cli users list — List
• posthog-pp-cli users partial-update — Update one or more of the authenticated user's profile fields or settings.
• posthog-pp-cli users request-email-verification-create — Request email verification create
• posthog-pp-cli users retrieve — Retrieve a user's profile and settings. Pass @me as the UUID to fetch the authenticated user; non-staff callers...
• posthog-pp-cli users update — Replace the authenticated user's profile and settings. Pass @me as the UUID to update the authenticated user....
• posthog-pp-cli users verify-email-create — Verify email create

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

posthog-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Find flags safe to archive

posthog-pp-cli flags stale --days 60 --json | jq '.[].key'

List flag keys with no evaluation events in 60 days — safe cleanup candidates

Pre-ramp safety check

posthog-pp-cli flags rollout-health --key new-checkout --window 48h --agent --select flag_key,error_rate_delta,metric_delta

Check error rate and purchase metric delta for flag-exposed users before ramping to 100%

Weekly experiment briefing

posthog-pp-cli experiments pre-check --json | jq '.[] | {key, winner, significance, days_remaining}'

Cross-experiment pre-check summary for Monday standup — surface experiments needing traffic adjustment

LLM cost by flag variant

posthog-pp-cli llm cost-attribution --flag model-tier --since 2026-08-01 --agent --select variant,total_cost_usd,avg_cost_per_call

Compare LLM spend across A/B variants to decide if GPT-4o outperforms GPT-4o-mini in your context