[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-posthog-debugging-local-replay":3,"mdc-o7kv76-key":49,"related-org-posthog-debugging-local-replay":1131,"related-repo-posthog-debugging-local-replay":1298},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":44,"sourceUrl":47,"mdContent":48},"debugging-local-replay","debug local PostHog replay ingestion","Debugs why session recordings aren't appearing in the local dev environment. Use when a developer reports that local replay ingestion isn't working, recordings aren't showing up despite \u002Fs calls, or the replay pipeline seems broken after hogli start. Covers the full local pipeline: SDK capture, Caddy proxy, capture-replay (Rust), Kafka, ingestion-sessionreplay (Node), recording-api (Node), SeaweedFS, and common failure modes like orphaned processes, stuck phrocs workers, and trigger misconfiguration.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"posthog","PostHog","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fposthog.png",[12,16,17,20],{"name":13,"slug":14,"type":15},"Observability","observability","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Local Development","local-development",{"name":21,"slug":22,"type":15},"Debugging","debugging",35568,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog","2026-05-02T05:34:34.195315",null,2977,[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"ab-testing","ai-analytics","analytics","cdp","data-warehouse","experiments","feature-flags","javascript","product-analytics","python","react","session-replay","surveys","typescript","web-analytics",{"repoUrl":24,"stars":23,"forks":27,"topics":45,"description":46},[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"🦔 PostHog is an all-in-one developer platform for building successful products. We offer product analytics, web analytics, session replay, error tracking, feature flags, experimentation, surveys, data warehouse, a CDP, and an AI product assistant to help debug your code, ship features faster, and keep all your usage and customer data in one stack.","https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog\u002Ftree\u002FHEAD\u002Fproducts\u002Freplay\u002Fskills\u002Fdebugging-local-replay","---\nname: debugging-local-replay\ndescription: >\n  Debugs why session recordings aren't appearing in the local dev environment.\n  Use when a developer reports that local replay ingestion isn't working,\n  recordings aren't showing up despite \u002Fs calls, or the replay pipeline\n  seems broken after hogli start. Covers the full local pipeline:\n  SDK capture, Caddy proxy, capture-replay (Rust), Kafka, ingestion-sessionreplay (Node),\n  recording-api (Node), SeaweedFS, and common failure modes like orphaned processes,\n  stuck phrocs workers, and trigger misconfiguration.\n---\n\n# Debugging local session replay\n\nWhen a developer says \"local replay isn't working\" or \"recordings aren't showing up\",\nwork through these layers in order.\nThe local replay pipeline has several moving parts and failures are usually silent.\n\n## Quick symptom guide\n\n| Symptom                                                | Likely cause                                                                              |\n| ------------------------------------------------------ | ----------------------------------------------------------------------------------------- |\n| No `\u002Fs` calls in Network tab                           | SDK not recording — triggers, settings, or recorder script issue (Step 1)                 |\n| `\u002Fs` calls return 200 but no recordings in list        | Ingestion pipeline broken — capture-replay, Kafka, or ingestion-sessionreplay (Steps 2-3) |\n| Recordings listed but playback stuck on \"Buffering...\" | `recording-api` (port 6741) not running (Step 2)                                          |\n| Recorder script MIME type or CORS error in console     | Frontend build stale — need `pnpm build` + `pnpm copy-scripts` (Step 1)                   |\n\n## The local replay pipeline\n\n```text\nBrowser SDK  →  \u002Fs endpoint (Caddy proxy :8000)\n             →  capture-replay (Rust, :3306)\n             →  Kafka (session_recording_snapshot_item_events topic)\n             →  ingestion-sessionreplay (Node, :6740, PLUGIN_SERVER_MODE=recordings-blob-ingestion-v2)\n             →  SeaweedFS (blob storage, :8333)\n             →  recording-api (Node, :6741, PLUGIN_SERVER_MODE=recording-api)\n             →  Frontend\n```\n\nA break at any point in this chain means no recordings in the UI.\nThe diagnostic approach is to find where the chain breaks.\n\n## Step 1 — Is the SDK even trying to record?\n\nAsk the developer to open browser DevTools Network tab and filter for `\u002Fs`.\n\n**If no `\u002Fs` calls at all:**\nThe SDK isn't attempting to send recording data. Investigate client-side causes:\n\n- **Triggers configured in project settings.** If URL triggers, event triggers, or linked flag triggers\n  are set up, recording won't start until a trigger fires. This is the most common cause for\n  developers who've been testing trigger features. Check Session replay settings in the local UI\n  (Project settings > Session replay). Remove or adjust triggers to allow recording to start.\n- **Recording disabled in project settings.** Session replay may be toggled off.\n- **Sample rate set too low.** If `$replay_sample_rate` is \u003C 1.0, sessions may be sampled out.\n- **SDK not initialized with recording.** Check the local app's PostHog initialization —\n  `session_recording` must not be explicitly disabled.\n- **Wrong PostHog host.** The local app must point to `http:\u002F\u002Flocalhost:8000` (or wherever\n  the local Caddy proxy is running).\n- **Ad blocker.** Even in local dev, browser extensions can block the recorder script or `\u002Fs` endpoint.\n- **Recorder script failed to load (MIME type \u002F CORS error).** The browser console may show\n  `MIME type ('text\u002Fhtml') is not executable` for `posthog-recorder.js` or a CORS error for\n  `lazy-recorder.js`. This means Django is serving an HTML page (usually the login redirect)\n  instead of the JS file — the static recorder scripts are stale or missing.\n  See [recorder script build failure](.\u002Freferences\u002Fcommon-failures.md#recorder-script-build-failure).\n\n**If `\u002Fs` calls are happening with 200 responses:**\nThe SDK is recording and capture is receiving data. The break is downstream — proceed to Step 2.\n\n**If `\u002Fs` calls are returning errors (4xx\u002F5xx):**\nThe capture service may be down or misconfigured. Check `capture-replay` in phrocs.\n\n## Step 2 — Are the required processes running?\n\nCheck that these phrocs processes are running and healthy.\nA \"running\" process that never produced output after `tsx watch src\u002Findex.ts` is effectively dead.\n\n### Key processes and their ports\n\n| Process                   | Port | What it does                                     |\n| ------------------------- | ---- | ------------------------------------------------ |\n| `capture-replay`          | 3306 | Rust service receiving `\u002Fs`, writes to Kafka     |\n| `ingestion-sessionreplay` | 6740 | Node consumer processing recordings from Kafka   |\n| `recording-api`           | 6741 | Node service serving replay data to the frontend |\n\nVerify with:\n\n```bash\nlsof -nP -i :3306 -i :6740 -i :6741\n```\n\n**If ports are not listening:**\nThe processes haven't started or are stuck. See [common failures](.\u002Freferences\u002Fcommon-failures.md).\n\n**If ports are listening:**\nThe pipeline processes are running. Proceed to Step 3.\n\n### Docker dependencies\n\nThese Docker containers must be running and healthy:\n\n| Container              | Purpose                          |\n| ---------------------- | -------------------------------- |\n| `posthog-kafka-1`      | Message bus for recording events |\n| `posthog-db-1`         | Postgres for metadata            |\n| `posthog-redis7-1`     | Redis for state                  |\n| `posthog-clickhouse-1` | ClickHouse for session data      |\n| `seaweedfs-main`       | Blob storage for recording data  |\n\nCheck with:\n\n```bash\ndocker ps --format \"table {{.Names}}\\t{{.Status}}\" | grep -E \"kafka|db|redis7|clickhouse|seaweed\"\n```\n\nAll should show `(healthy)` except seaweedfs which doesn't have a health check.\nIf `seaweedfs-main` is missing, the `replay` Docker profile may not be active —\ncheck the `docker-compose` phrocs process output for `--profile replay`.\n\n## Step 3 — Is data flowing through Kafka?\n\nIf capture-replay is running and receiving `\u002Fs` calls, data should land on the\n`session_recording_snapshot_item_events` Kafka topic. Check the Kafka UI at\n`http:\u002F\u002Flocalhost:8080` (if the `debug_tools` intent is enabled) or use kcat:\n\n```bash\nkcat -b localhost:9092 -t session_recording_snapshot_item_events -C -c 5 -e\n```\n\n**If the topic is empty or doesn't exist:**\ncapture-replay isn't writing to Kafka. Check its phrocs logs for Kafka connection errors.\n\n**If data is on the topic but recordings don't appear:**\ningestion-sessionreplay isn't consuming. Check if it's stuck, crashed, or if an\norphaned process is holding the consumer group (see common failures).\n\n## Step 4 — Check SeaweedFS\n\nIngestion writes recording blobs to SeaweedFS. Verify it's accessible:\n\n```bash\ncurl -s http:\u002F\u002Flocalhost:8333\u002F | head -5\n```\n\nThe `SESSION_RECORDING_V2_S3_ENDPOINT` env var must be set correctly.\nIn `bin\u002Fstart`, this defaults to `http:\u002F\u002Fseaweedfs:8333` (the Docker hostname).\nHost processes resolve this via Docker networking.\n\n## Common failures reference\n\nSee [common failures](.\u002Freferences\u002Fcommon-failures.md) for detailed diagnosis of:\n\n- Orphaned Node processes holding Kafka consumer groups\n- Processes stuck at `bin\u002Fwait-for-docker`\n- tsx watch silently swallowing crashes\n- Port conflicts between Docker and host processes\n- Cargo build lock contention on startup\n",{"data":50,"body":51},{"name":4,"description":6},{"type":52,"children":53},"root",[54,63,69,76,192,198,210,215,221,233,251,389,406,430,436,449,456,554,559,614,631,641,647,652,759,764,834,877,883,919,975,985,995,1001,1006,1045,1074,1080,1091,1125],{"type":55,"tag":56,"props":57,"children":59},"element","h1",{"id":58},"debugging-local-session-replay",[60],{"type":61,"value":62},"text","Debugging local session replay",{"type":55,"tag":64,"props":65,"children":66},"p",{},[67],{"type":61,"value":68},"When a developer says \"local replay isn't working\" or \"recordings aren't showing up\",\nwork through these layers in order.\nThe local replay pipeline has several moving parts and failures are usually silent.",{"type":55,"tag":70,"props":71,"children":73},"h2",{"id":72},"quick-symptom-guide",[74],{"type":61,"value":75},"Quick symptom guide",{"type":55,"tag":77,"props":78,"children":79},"table",{},[80,99],{"type":55,"tag":81,"props":82,"children":83},"thead",{},[84],{"type":55,"tag":85,"props":86,"children":87},"tr",{},[88,94],{"type":55,"tag":89,"props":90,"children":91},"th",{},[92],{"type":61,"value":93},"Symptom",{"type":55,"tag":89,"props":95,"children":96},{},[97],{"type":61,"value":98},"Likely cause",{"type":55,"tag":100,"props":101,"children":102},"tbody",{},[103,126,144,163],{"type":55,"tag":85,"props":104,"children":105},{},[106,121],{"type":55,"tag":107,"props":108,"children":109},"td",{},[110,112,119],{"type":61,"value":111},"No ",{"type":55,"tag":113,"props":114,"children":116},"code",{"className":115},[],[117],{"type":61,"value":118},"\u002Fs",{"type":61,"value":120}," calls in Network tab",{"type":55,"tag":107,"props":122,"children":123},{},[124],{"type":61,"value":125},"SDK not recording — triggers, settings, or recorder script issue (Step 1)",{"type":55,"tag":85,"props":127,"children":128},{},[129,139],{"type":55,"tag":107,"props":130,"children":131},{},[132,137],{"type":55,"tag":113,"props":133,"children":135},{"className":134},[],[136],{"type":61,"value":118},{"type":61,"value":138}," calls return 200 but no recordings in list",{"type":55,"tag":107,"props":140,"children":141},{},[142],{"type":61,"value":143},"Ingestion pipeline broken — capture-replay, Kafka, or ingestion-sessionreplay (Steps 2-3)",{"type":55,"tag":85,"props":145,"children":146},{},[147,152],{"type":55,"tag":107,"props":148,"children":149},{},[150],{"type":61,"value":151},"Recordings listed but playback stuck on \"Buffering...\"",{"type":55,"tag":107,"props":153,"children":154},{},[155,161],{"type":55,"tag":113,"props":156,"children":158},{"className":157},[],[159],{"type":61,"value":160},"recording-api",{"type":61,"value":162}," (port 6741) not running (Step 2)",{"type":55,"tag":85,"props":164,"children":165},{},[166,171],{"type":55,"tag":107,"props":167,"children":168},{},[169],{"type":61,"value":170},"Recorder script MIME type or CORS error in console",{"type":55,"tag":107,"props":172,"children":173},{},[174,176,182,184,190],{"type":61,"value":175},"Frontend build stale — need ",{"type":55,"tag":113,"props":177,"children":179},{"className":178},[],[180],{"type":61,"value":181},"pnpm build",{"type":61,"value":183}," + ",{"type":55,"tag":113,"props":185,"children":187},{"className":186},[],[188],{"type":61,"value":189},"pnpm copy-scripts",{"type":61,"value":191}," (Step 1)",{"type":55,"tag":70,"props":193,"children":195},{"id":194},"the-local-replay-pipeline",[196],{"type":61,"value":197},"The local replay pipeline",{"type":55,"tag":199,"props":200,"children":205},"pre",{"className":201,"code":203,"language":61,"meta":204},[202],"language-text","Browser SDK  →  \u002Fs endpoint (Caddy proxy :8000)\n             →  capture-replay (Rust, :3306)\n             →  Kafka (session_recording_snapshot_item_events topic)\n             →  ingestion-sessionreplay (Node, :6740, PLUGIN_SERVER_MODE=recordings-blob-ingestion-v2)\n             →  SeaweedFS (blob storage, :8333)\n             →  recording-api (Node, :6741, PLUGIN_SERVER_MODE=recording-api)\n             →  Frontend\n","",[206],{"type":55,"tag":113,"props":207,"children":208},{"__ignoreMap":204},[209],{"type":61,"value":203},{"type":55,"tag":64,"props":211,"children":212},{},[213],{"type":61,"value":214},"A break at any point in this chain means no recordings in the UI.\nThe diagnostic approach is to find where the chain breaks.",{"type":55,"tag":70,"props":216,"children":218},{"id":217},"step-1-is-the-sdk-even-trying-to-record",[219],{"type":61,"value":220},"Step 1 — Is the SDK even trying to record?",{"type":55,"tag":64,"props":222,"children":223},{},[224,226,231],{"type":61,"value":225},"Ask the developer to open browser DevTools Network tab and filter for ",{"type":55,"tag":113,"props":227,"children":229},{"className":228},[],[230],{"type":61,"value":118},{"type":61,"value":232},".",{"type":55,"tag":64,"props":234,"children":235},{},[236,249],{"type":55,"tag":237,"props":238,"children":239},"strong",{},[240,242,247],{"type":61,"value":241},"If no ",{"type":55,"tag":113,"props":243,"children":245},{"className":244},[],[246],{"type":61,"value":118},{"type":61,"value":248}," calls at all:",{"type":61,"value":250},"\nThe SDK isn't attempting to send recording data. Investigate client-side causes:",{"type":55,"tag":252,"props":253,"children":254},"ul",{},[255,266,276,294,312,330,347],{"type":55,"tag":256,"props":257,"children":258},"li",{},[259,264],{"type":55,"tag":237,"props":260,"children":261},{},[262],{"type":61,"value":263},"Triggers configured in project settings.",{"type":61,"value":265}," If URL triggers, event triggers, or linked flag triggers\nare set up, recording won't start until a trigger fires. This is the most common cause for\ndevelopers who've been testing trigger features. Check Session replay settings in the local UI\n(Project settings > Session replay). Remove or adjust triggers to allow recording to start.",{"type":55,"tag":256,"props":267,"children":268},{},[269,274],{"type":55,"tag":237,"props":270,"children":271},{},[272],{"type":61,"value":273},"Recording disabled in project settings.",{"type":61,"value":275}," Session replay may be toggled off.",{"type":55,"tag":256,"props":277,"children":278},{},[279,284,286,292],{"type":55,"tag":237,"props":280,"children":281},{},[282],{"type":61,"value":283},"Sample rate set too low.",{"type":61,"value":285}," If ",{"type":55,"tag":113,"props":287,"children":289},{"className":288},[],[290],{"type":61,"value":291},"$replay_sample_rate",{"type":61,"value":293}," is \u003C 1.0, sessions may be sampled out.",{"type":55,"tag":256,"props":295,"children":296},{},[297,302,304,310],{"type":55,"tag":237,"props":298,"children":299},{},[300],{"type":61,"value":301},"SDK not initialized with recording.",{"type":61,"value":303}," Check the local app's PostHog initialization —\n",{"type":55,"tag":113,"props":305,"children":307},{"className":306},[],[308],{"type":61,"value":309},"session_recording",{"type":61,"value":311}," must not be explicitly disabled.",{"type":55,"tag":256,"props":313,"children":314},{},[315,320,322,328],{"type":55,"tag":237,"props":316,"children":317},{},[318],{"type":61,"value":319},"Wrong PostHog host.",{"type":61,"value":321}," The local app must point to ",{"type":55,"tag":113,"props":323,"children":325},{"className":324},[],[326],{"type":61,"value":327},"http:\u002F\u002Flocalhost:8000",{"type":61,"value":329}," (or wherever\nthe local Caddy proxy is running).",{"type":55,"tag":256,"props":331,"children":332},{},[333,338,340,345],{"type":55,"tag":237,"props":334,"children":335},{},[336],{"type":61,"value":337},"Ad blocker.",{"type":61,"value":339}," Even in local dev, browser extensions can block the recorder script or ",{"type":55,"tag":113,"props":341,"children":343},{"className":342},[],[344],{"type":61,"value":118},{"type":61,"value":346}," endpoint.",{"type":55,"tag":256,"props":348,"children":349},{},[350,355,357,363,365,371,373,379,381,388],{"type":55,"tag":237,"props":351,"children":352},{},[353],{"type":61,"value":354},"Recorder script failed to load (MIME type \u002F CORS error).",{"type":61,"value":356}," The browser console may show\n",{"type":55,"tag":113,"props":358,"children":360},{"className":359},[],[361],{"type":61,"value":362},"MIME type ('text\u002Fhtml') is not executable",{"type":61,"value":364}," for ",{"type":55,"tag":113,"props":366,"children":368},{"className":367},[],[369],{"type":61,"value":370},"posthog-recorder.js",{"type":61,"value":372}," or a CORS error for\n",{"type":55,"tag":113,"props":374,"children":376},{"className":375},[],[377],{"type":61,"value":378},"lazy-recorder.js",{"type":61,"value":380},". This means Django is serving an HTML page (usually the login redirect)\ninstead of the JS file — the static recorder scripts are stale or missing.\nSee ",{"type":55,"tag":382,"props":383,"children":385},"a",{"href":384},".\u002Freferences\u002Fcommon-failures.md#recorder-script-build-failure",[386],{"type":61,"value":387},"recorder script build failure",{"type":61,"value":232},{"type":55,"tag":64,"props":390,"children":391},{},[392,404],{"type":55,"tag":237,"props":393,"children":394},{},[395,397,402],{"type":61,"value":396},"If ",{"type":55,"tag":113,"props":398,"children":400},{"className":399},[],[401],{"type":61,"value":118},{"type":61,"value":403}," calls are happening with 200 responses:",{"type":61,"value":405},"\nThe SDK is recording and capture is receiving data. The break is downstream — proceed to Step 2.",{"type":55,"tag":64,"props":407,"children":408},{},[409,420,422,428],{"type":55,"tag":237,"props":410,"children":411},{},[412,413,418],{"type":61,"value":396},{"type":55,"tag":113,"props":414,"children":416},{"className":415},[],[417],{"type":61,"value":118},{"type":61,"value":419}," calls are returning errors (4xx\u002F5xx):",{"type":61,"value":421},"\nThe capture service may be down or misconfigured. Check ",{"type":55,"tag":113,"props":423,"children":425},{"className":424},[],[426],{"type":61,"value":427},"capture-replay",{"type":61,"value":429}," in phrocs.",{"type":55,"tag":70,"props":431,"children":433},{"id":432},"step-2-are-the-required-processes-running",[434],{"type":61,"value":435},"Step 2 — Are the required processes running?",{"type":55,"tag":64,"props":437,"children":438},{},[439,441,447],{"type":61,"value":440},"Check that these phrocs processes are running and healthy.\nA \"running\" process that never produced output after ",{"type":55,"tag":113,"props":442,"children":444},{"className":443},[],[445],{"type":61,"value":446},"tsx watch src\u002Findex.ts",{"type":61,"value":448}," is effectively dead.",{"type":55,"tag":450,"props":451,"children":453},"h3",{"id":452},"key-processes-and-their-ports",[454],{"type":61,"value":455},"Key processes and their ports",{"type":55,"tag":77,"props":457,"children":458},{},[459,480],{"type":55,"tag":81,"props":460,"children":461},{},[462],{"type":55,"tag":85,"props":463,"children":464},{},[465,470,475],{"type":55,"tag":89,"props":466,"children":467},{},[468],{"type":61,"value":469},"Process",{"type":55,"tag":89,"props":471,"children":472},{},[473],{"type":61,"value":474},"Port",{"type":55,"tag":89,"props":476,"children":477},{},[478],{"type":61,"value":479},"What it does",{"type":55,"tag":100,"props":481,"children":482},{},[483,511,533],{"type":55,"tag":85,"props":484,"children":485},{},[486,494,499],{"type":55,"tag":107,"props":487,"children":488},{},[489],{"type":55,"tag":113,"props":490,"children":492},{"className":491},[],[493],{"type":61,"value":427},{"type":55,"tag":107,"props":495,"children":496},{},[497],{"type":61,"value":498},"3306",{"type":55,"tag":107,"props":500,"children":501},{},[502,504,509],{"type":61,"value":503},"Rust service receiving ",{"type":55,"tag":113,"props":505,"children":507},{"className":506},[],[508],{"type":61,"value":118},{"type":61,"value":510},", writes to Kafka",{"type":55,"tag":85,"props":512,"children":513},{},[514,523,528],{"type":55,"tag":107,"props":515,"children":516},{},[517],{"type":55,"tag":113,"props":518,"children":520},{"className":519},[],[521],{"type":61,"value":522},"ingestion-sessionreplay",{"type":55,"tag":107,"props":524,"children":525},{},[526],{"type":61,"value":527},"6740",{"type":55,"tag":107,"props":529,"children":530},{},[531],{"type":61,"value":532},"Node consumer processing recordings from Kafka",{"type":55,"tag":85,"props":534,"children":535},{},[536,544,549],{"type":55,"tag":107,"props":537,"children":538},{},[539],{"type":55,"tag":113,"props":540,"children":542},{"className":541},[],[543],{"type":61,"value":160},{"type":55,"tag":107,"props":545,"children":546},{},[547],{"type":61,"value":548},"6741",{"type":55,"tag":107,"props":550,"children":551},{},[552],{"type":61,"value":553},"Node service serving replay data to the frontend",{"type":55,"tag":64,"props":555,"children":556},{},[557],{"type":61,"value":558},"Verify with:",{"type":55,"tag":199,"props":560,"children":564},{"className":561,"code":562,"language":563,"meta":204,"style":204},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","lsof -nP -i :3306 -i :6740 -i :6741\n","bash",[565],{"type":55,"tag":113,"props":566,"children":567},{"__ignoreMap":204},[568],{"type":55,"tag":569,"props":570,"children":573},"span",{"class":571,"line":572},"line",1,[574,580,586,591,596,600,605,609],{"type":55,"tag":569,"props":575,"children":577},{"style":576},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[578],{"type":61,"value":579},"lsof",{"type":55,"tag":569,"props":581,"children":583},{"style":582},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[584],{"type":61,"value":585}," -nP",{"type":55,"tag":569,"props":587,"children":588},{"style":582},[589],{"type":61,"value":590}," -i",{"type":55,"tag":569,"props":592,"children":593},{"style":582},[594],{"type":61,"value":595}," :3306",{"type":55,"tag":569,"props":597,"children":598},{"style":582},[599],{"type":61,"value":590},{"type":55,"tag":569,"props":601,"children":602},{"style":582},[603],{"type":61,"value":604}," :6740",{"type":55,"tag":569,"props":606,"children":607},{"style":582},[608],{"type":61,"value":590},{"type":55,"tag":569,"props":610,"children":611},{"style":582},[612],{"type":61,"value":613}," :6741\n",{"type":55,"tag":64,"props":615,"children":616},{},[617,622,624,630],{"type":55,"tag":237,"props":618,"children":619},{},[620],{"type":61,"value":621},"If ports are not listening:",{"type":61,"value":623},"\nThe processes haven't started or are stuck. See ",{"type":55,"tag":382,"props":625,"children":627},{"href":626},".\u002Freferences\u002Fcommon-failures.md",[628],{"type":61,"value":629},"common failures",{"type":61,"value":232},{"type":55,"tag":64,"props":632,"children":633},{},[634,639],{"type":55,"tag":237,"props":635,"children":636},{},[637],{"type":61,"value":638},"If ports are listening:",{"type":61,"value":640},"\nThe pipeline processes are running. Proceed to Step 3.",{"type":55,"tag":450,"props":642,"children":644},{"id":643},"docker-dependencies",[645],{"type":61,"value":646},"Docker dependencies",{"type":55,"tag":64,"props":648,"children":649},{},[650],{"type":61,"value":651},"These Docker containers must be running and healthy:",{"type":55,"tag":77,"props":653,"children":654},{},[655,671],{"type":55,"tag":81,"props":656,"children":657},{},[658],{"type":55,"tag":85,"props":659,"children":660},{},[661,666],{"type":55,"tag":89,"props":662,"children":663},{},[664],{"type":61,"value":665},"Container",{"type":55,"tag":89,"props":667,"children":668},{},[669],{"type":61,"value":670},"Purpose",{"type":55,"tag":100,"props":672,"children":673},{},[674,691,708,725,742],{"type":55,"tag":85,"props":675,"children":676},{},[677,686],{"type":55,"tag":107,"props":678,"children":679},{},[680],{"type":55,"tag":113,"props":681,"children":683},{"className":682},[],[684],{"type":61,"value":685},"posthog-kafka-1",{"type":55,"tag":107,"props":687,"children":688},{},[689],{"type":61,"value":690},"Message bus for recording events",{"type":55,"tag":85,"props":692,"children":693},{},[694,703],{"type":55,"tag":107,"props":695,"children":696},{},[697],{"type":55,"tag":113,"props":698,"children":700},{"className":699},[],[701],{"type":61,"value":702},"posthog-db-1",{"type":55,"tag":107,"props":704,"children":705},{},[706],{"type":61,"value":707},"Postgres for metadata",{"type":55,"tag":85,"props":709,"children":710},{},[711,720],{"type":55,"tag":107,"props":712,"children":713},{},[714],{"type":55,"tag":113,"props":715,"children":717},{"className":716},[],[718],{"type":61,"value":719},"posthog-redis7-1",{"type":55,"tag":107,"props":721,"children":722},{},[723],{"type":61,"value":724},"Redis for state",{"type":55,"tag":85,"props":726,"children":727},{},[728,737],{"type":55,"tag":107,"props":729,"children":730},{},[731],{"type":55,"tag":113,"props":732,"children":734},{"className":733},[],[735],{"type":61,"value":736},"posthog-clickhouse-1",{"type":55,"tag":107,"props":738,"children":739},{},[740],{"type":61,"value":741},"ClickHouse for session data",{"type":55,"tag":85,"props":743,"children":744},{},[745,754],{"type":55,"tag":107,"props":746,"children":747},{},[748],{"type":55,"tag":113,"props":749,"children":751},{"className":750},[],[752],{"type":61,"value":753},"seaweedfs-main",{"type":55,"tag":107,"props":755,"children":756},{},[757],{"type":61,"value":758},"Blob storage for recording data",{"type":55,"tag":64,"props":760,"children":761},{},[762],{"type":61,"value":763},"Check with:",{"type":55,"tag":199,"props":765,"children":767},{"className":561,"code":766,"language":563,"meta":204,"style":204},"docker ps --format \"table {{.Names}}\\t{{.Status}}\" | grep -E \"kafka|db|redis7|clickhouse|seaweed\"\n",[768],{"type":55,"tag":113,"props":769,"children":770},{"__ignoreMap":204},[771],{"type":55,"tag":569,"props":772,"children":773},{"class":571,"line":572},[774,779,784,789,795,800,805,810,815,820,824,829],{"type":55,"tag":569,"props":775,"children":776},{"style":576},[777],{"type":61,"value":778},"docker",{"type":55,"tag":569,"props":780,"children":781},{"style":582},[782],{"type":61,"value":783}," ps",{"type":55,"tag":569,"props":785,"children":786},{"style":582},[787],{"type":61,"value":788}," --format",{"type":55,"tag":569,"props":790,"children":792},{"style":791},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[793],{"type":61,"value":794}," \"",{"type":55,"tag":569,"props":796,"children":797},{"style":582},[798],{"type":61,"value":799},"table {{.Names}}\\t{{.Status}}",{"type":55,"tag":569,"props":801,"children":802},{"style":791},[803],{"type":61,"value":804},"\"",{"type":55,"tag":569,"props":806,"children":807},{"style":791},[808],{"type":61,"value":809}," |",{"type":55,"tag":569,"props":811,"children":812},{"style":576},[813],{"type":61,"value":814}," grep",{"type":55,"tag":569,"props":816,"children":817},{"style":582},[818],{"type":61,"value":819}," -E",{"type":55,"tag":569,"props":821,"children":822},{"style":791},[823],{"type":61,"value":794},{"type":55,"tag":569,"props":825,"children":826},{"style":582},[827],{"type":61,"value":828},"kafka|db|redis7|clickhouse|seaweed",{"type":55,"tag":569,"props":830,"children":831},{"style":791},[832],{"type":61,"value":833},"\"\n",{"type":55,"tag":64,"props":835,"children":836},{},[837,839,845,847,852,854,860,862,868,870,876],{"type":61,"value":838},"All should show ",{"type":55,"tag":113,"props":840,"children":842},{"className":841},[],[843],{"type":61,"value":844},"(healthy)",{"type":61,"value":846}," except seaweedfs which doesn't have a health check.\nIf ",{"type":55,"tag":113,"props":848,"children":850},{"className":849},[],[851],{"type":61,"value":753},{"type":61,"value":853}," is missing, the ",{"type":55,"tag":113,"props":855,"children":857},{"className":856},[],[858],{"type":61,"value":859},"replay",{"type":61,"value":861}," Docker profile may not be active —\ncheck the ",{"type":55,"tag":113,"props":863,"children":865},{"className":864},[],[866],{"type":61,"value":867},"docker-compose",{"type":61,"value":869}," phrocs process output for ",{"type":55,"tag":113,"props":871,"children":873},{"className":872},[],[874],{"type":61,"value":875},"--profile replay",{"type":61,"value":232},{"type":55,"tag":70,"props":878,"children":880},{"id":879},"step-3-is-data-flowing-through-kafka",[881],{"type":61,"value":882},"Step 3 — Is data flowing through Kafka?",{"type":55,"tag":64,"props":884,"children":885},{},[886,888,893,895,901,903,909,911,917],{"type":61,"value":887},"If capture-replay is running and receiving ",{"type":55,"tag":113,"props":889,"children":891},{"className":890},[],[892],{"type":61,"value":118},{"type":61,"value":894}," calls, data should land on the\n",{"type":55,"tag":113,"props":896,"children":898},{"className":897},[],[899],{"type":61,"value":900},"session_recording_snapshot_item_events",{"type":61,"value":902}," Kafka topic. Check the Kafka UI at\n",{"type":55,"tag":113,"props":904,"children":906},{"className":905},[],[907],{"type":61,"value":908},"http:\u002F\u002Flocalhost:8080",{"type":61,"value":910}," (if the ",{"type":55,"tag":113,"props":912,"children":914},{"className":913},[],[915],{"type":61,"value":916},"debug_tools",{"type":61,"value":918}," intent is enabled) or use kcat:",{"type":55,"tag":199,"props":920,"children":922},{"className":561,"code":921,"language":563,"meta":204,"style":204},"kcat -b localhost:9092 -t session_recording_snapshot_item_events -C -c 5 -e\n",[923],{"type":55,"tag":113,"props":924,"children":925},{"__ignoreMap":204},[926],{"type":55,"tag":569,"props":927,"children":928},{"class":571,"line":572},[929,934,939,944,949,954,959,964,970],{"type":55,"tag":569,"props":930,"children":931},{"style":576},[932],{"type":61,"value":933},"kcat",{"type":55,"tag":569,"props":935,"children":936},{"style":582},[937],{"type":61,"value":938}," -b",{"type":55,"tag":569,"props":940,"children":941},{"style":582},[942],{"type":61,"value":943}," localhost:9092",{"type":55,"tag":569,"props":945,"children":946},{"style":582},[947],{"type":61,"value":948}," -t",{"type":55,"tag":569,"props":950,"children":951},{"style":582},[952],{"type":61,"value":953}," session_recording_snapshot_item_events",{"type":55,"tag":569,"props":955,"children":956},{"style":582},[957],{"type":61,"value":958}," -C",{"type":55,"tag":569,"props":960,"children":961},{"style":582},[962],{"type":61,"value":963}," -c",{"type":55,"tag":569,"props":965,"children":967},{"style":966},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[968],{"type":61,"value":969}," 5",{"type":55,"tag":569,"props":971,"children":972},{"style":582},[973],{"type":61,"value":974}," -e\n",{"type":55,"tag":64,"props":976,"children":977},{},[978,983],{"type":55,"tag":237,"props":979,"children":980},{},[981],{"type":61,"value":982},"If the topic is empty or doesn't exist:",{"type":61,"value":984},"\ncapture-replay isn't writing to Kafka. Check its phrocs logs for Kafka connection errors.",{"type":55,"tag":64,"props":986,"children":987},{},[988,993],{"type":55,"tag":237,"props":989,"children":990},{},[991],{"type":61,"value":992},"If data is on the topic but recordings don't appear:",{"type":61,"value":994},"\ningestion-sessionreplay isn't consuming. Check if it's stuck, crashed, or if an\norphaned process is holding the consumer group (see common failures).",{"type":55,"tag":70,"props":996,"children":998},{"id":997},"step-4-check-seaweedfs",[999],{"type":61,"value":1000},"Step 4 — Check SeaweedFS",{"type":55,"tag":64,"props":1002,"children":1003},{},[1004],{"type":61,"value":1005},"Ingestion writes recording blobs to SeaweedFS. Verify it's accessible:",{"type":55,"tag":199,"props":1007,"children":1009},{"className":561,"code":1008,"language":563,"meta":204,"style":204},"curl -s http:\u002F\u002Flocalhost:8333\u002F | head -5\n",[1010],{"type":55,"tag":113,"props":1011,"children":1012},{"__ignoreMap":204},[1013],{"type":55,"tag":569,"props":1014,"children":1015},{"class":571,"line":572},[1016,1021,1026,1031,1035,1040],{"type":55,"tag":569,"props":1017,"children":1018},{"style":576},[1019],{"type":61,"value":1020},"curl",{"type":55,"tag":569,"props":1022,"children":1023},{"style":582},[1024],{"type":61,"value":1025}," -s",{"type":55,"tag":569,"props":1027,"children":1028},{"style":582},[1029],{"type":61,"value":1030}," http:\u002F\u002Flocalhost:8333\u002F",{"type":55,"tag":569,"props":1032,"children":1033},{"style":791},[1034],{"type":61,"value":809},{"type":55,"tag":569,"props":1036,"children":1037},{"style":576},[1038],{"type":61,"value":1039}," head",{"type":55,"tag":569,"props":1041,"children":1042},{"style":582},[1043],{"type":61,"value":1044}," -5\n",{"type":55,"tag":64,"props":1046,"children":1047},{},[1048,1050,1056,1058,1064,1066,1072],{"type":61,"value":1049},"The ",{"type":55,"tag":113,"props":1051,"children":1053},{"className":1052},[],[1054],{"type":61,"value":1055},"SESSION_RECORDING_V2_S3_ENDPOINT",{"type":61,"value":1057}," env var must be set correctly.\nIn ",{"type":55,"tag":113,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":61,"value":1063},"bin\u002Fstart",{"type":61,"value":1065},", this defaults to ",{"type":55,"tag":113,"props":1067,"children":1069},{"className":1068},[],[1070],{"type":61,"value":1071},"http:\u002F\u002Fseaweedfs:8333",{"type":61,"value":1073}," (the Docker hostname).\nHost processes resolve this via Docker networking.",{"type":55,"tag":70,"props":1075,"children":1077},{"id":1076},"common-failures-reference",[1078],{"type":61,"value":1079},"Common failures reference",{"type":55,"tag":64,"props":1081,"children":1082},{},[1083,1085,1089],{"type":61,"value":1084},"See ",{"type":55,"tag":382,"props":1086,"children":1087},{"href":626},[1088],{"type":61,"value":629},{"type":61,"value":1090}," for detailed diagnosis of:",{"type":55,"tag":252,"props":1092,"children":1093},{},[1094,1099,1110,1115,1120],{"type":55,"tag":256,"props":1095,"children":1096},{},[1097],{"type":61,"value":1098},"Orphaned Node processes holding Kafka consumer groups",{"type":55,"tag":256,"props":1100,"children":1101},{},[1102,1104],{"type":61,"value":1103},"Processes stuck at ",{"type":55,"tag":113,"props":1105,"children":1107},{"className":1106},[],[1108],{"type":61,"value":1109},"bin\u002Fwait-for-docker",{"type":55,"tag":256,"props":1111,"children":1112},{},[1113],{"type":61,"value":1114},"tsx watch silently swallowing crashes",{"type":55,"tag":256,"props":1116,"children":1117},{},[1118],{"type":61,"value":1119},"Port conflicts between Docker and host processes",{"type":55,"tag":256,"props":1121,"children":1122},{},[1123],{"type":61,"value":1124},"Cargo build lock contention on startup",{"type":55,"tag":1126,"props":1127,"children":1128},"style",{},[1129],{"type":61,"value":1130},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1132,"total":1297},[1133,1147,1159,1171,1184,1197,1213,1230,1244,1259,1269,1287],{"slug":1134,"name":1134,"fn":1135,"description":1136,"org":1137,"tags":1138,"stars":23,"repoUrl":24,"updatedAt":1146},"analyzing-expensive-users","analyze expensive users in AI observability","Analyze the most expensive users in AI observability and explain why they cost so much. Use when the user asks about top spenders, expensive users, per-user LLM cost, user-level cost drivers, or patterns behind high AI observability spend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1139,1141,1144,1145],{"name":1140,"slug":31,"type":15},"Analytics",{"name":1142,"slug":1143,"type":15},"Cost Optimization","cost-optimization",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-07-28T05:34:11.117757",{"slug":1148,"name":1148,"fn":1149,"description":1150,"org":1151,"tags":1152,"stars":23,"repoUrl":24,"updatedAt":1158},"auditing-endpoints","audit PostHog project endpoints","Audit every endpoint in a PostHog project for staleness, failed materialisations, and unused materialised versions. Use when the user asks \"what endpoints can I clean up?\", \"are any of my endpoints broken?\", \"which materialised versions are still being called?\", or wants a one-shot cleanup pass over the Endpoints product. Produces a prioritised report grouped by issue type, with recommended actions but does not modify anything without explicit confirmation.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1153,1154,1157],{"name":1140,"slug":31,"type":15},{"name":1155,"slug":1156,"type":15},"Audit","audit",{"name":9,"slug":8,"type":15},"2026-06-08T08:08:33.693989",{"slug":1160,"name":1160,"fn":1161,"description":1162,"org":1163,"tags":1164,"stars":23,"repoUrl":24,"updatedAt":1170},"auditing-warehouse-source-health","audit PostHog data warehouse source health","Audit the health of a PostHog project's data warehouse sources and syncs — find every broken or degraded source connection, sync schema, and webhook channel. Use when the user asks \"why are my imports failing?\", \"what's broken with my sources?\", \"why is my warehouse data stale?\", or wants a one-shot triage of source\u002Fsync health before deciding where to dig in. Produces a prioritized report grouped by severity, with recommended next steps. For materialized-view health use `auditing-warehouse-view-health`; for a single failing sync use `diagnosing-failed-warehouse-syncs`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1165,1166,1168,1169],{"name":1155,"slug":1156,"type":15},{"name":1167,"slug":33,"type":15},"Data Warehouse",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:22:57.67984",{"slug":1172,"name":1172,"fn":1173,"description":1174,"org":1175,"tags":1176,"stars":23,"repoUrl":24,"updatedAt":1183},"auditing-warehouse-view-health","audit PostHog materialized view health","Audit the health of a PostHog project's materialized views (saved queries) — find every failed materialization and flag unused or stale materialized views that cost storage and compute. Use when the user asks \"which of my views are broken?\", \"why is this materialized view failing?\", \"are any of my views wasting compute?\", or wants a one-shot triage of view health. For source\u002Fsync health use `auditing-warehouse-source-health`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1177,1178,1179,1182],{"name":1155,"slug":1156,"type":15},{"name":1167,"slug":33,"type":15},{"name":1180,"slug":1181,"type":15},"Performance","performance",{"name":9,"slug":8,"type":15},"2026-06-18T08:25:10.936787",{"slug":1185,"name":1185,"fn":1186,"description":1187,"org":1188,"tags":1189,"stars":23,"repoUrl":24,"updatedAt":1196},"authoring-error-tracking-alerts","author PostHog error tracking alerts","Author error tracking alerts that fire when an issue is created, reopened, or starts spiking. Use when the user asks to set up error notifications, route exceptions to Slack\u002Fwebhook\u002FLinear, or evaluate which error events are worth alerting on. Covers trigger-event selection, integration choice, dedup against existing alerts, and shipping with the canonical message body shape.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1190,1193,1194,1195],{"name":1191,"slug":1192,"type":15},"Alerting","alerting",{"name":21,"slug":22,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:24:40.318583",{"slug":1198,"name":1198,"fn":1199,"description":1200,"org":1201,"tags":1202,"stars":23,"repoUrl":24,"updatedAt":1212},"authoring-log-alerts","author log alerts in PostHog","Author useful, low-noise log alerts on services in a PostHog project. Use when the user asks to set up alerts for their logs, suggest alerts they should add, or evaluate whether a service is worth monitoring. Covers service triage, baseline characterisation, threshold drafting, back-testing via simulate, and shipping with a notification destination.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1203,1204,1207,1208,1211],{"name":1140,"slug":31,"type":15},{"name":1205,"slug":1206,"type":15},"Monitoring","monitoring",{"name":13,"slug":14,"type":15},{"name":1209,"slug":1210,"type":15},"Operations","operations",{"name":9,"slug":8,"type":15},"2026-07-18T05:10:54.430898",{"slug":1214,"name":1214,"fn":1215,"description":1216,"org":1217,"tags":1218,"stars":23,"repoUrl":24,"updatedAt":1229},"building-workflows","build and edit PostHog workflows","Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action\u002Fedge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence, or event-triggered automation in the workflows product.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1219,1222,1225,1226],{"name":1220,"slug":1221,"type":15},"Automation","automation",{"name":1223,"slug":1224,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},{"name":1227,"slug":1228,"type":15},"Workflow Automation","workflow-automation","2026-07-28T05:34:12.167015",{"slug":1231,"name":1231,"fn":1232,"description":1233,"org":1234,"tags":1235,"stars":23,"repoUrl":24,"updatedAt":1243},"check-posthog-loading","inspect PostHog SDK loading across URLs","Inspect how the PostHog JavaScript SDK is loaded across a list of URLs. Use to confirm consistent installation across pages, find pages missing the snippet, detect mismatched API keys or hosts between pages, and verify the load method (head snippet vs deferred vs array.js).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1236,1237,1238,1241,1242],{"name":1140,"slug":31,"type":15},{"name":21,"slug":22,"type":15},{"name":1239,"slug":1240,"type":15},"Frontend","frontend",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-05-07T05:56:19.828048",{"slug":1245,"name":1245,"fn":1246,"description":1247,"org":1248,"tags":1249,"stars":23,"repoUrl":24,"updatedAt":1258},"consuming-endpoints-from-client-code","integrate PostHog endpoints into client applications","Wire a PostHog endpoint into a client app or SDK. Covers fetching the OpenAPI spec, generating a typed client with openapi-generator or @hey-api\u002Fopenapi-ts, sending the right auth header, shaping the variables payload (HogQL code_name vs insight breakdown property), handling rate-limit and materialised-endpoint error responses. Use when the user says \"how do I call my endpoint\", \"generate a client for this\", or \"what auth header do I use\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1250,1253,1254,1255],{"name":1251,"slug":1252,"type":15},"API Development","api-development",{"name":1239,"slug":1240,"type":15},{"name":9,"slug":8,"type":15},{"name":1256,"slug":1257,"type":15},"SDK","sdk","2026-06-08T08:08:34.929454",{"slug":1260,"name":1260,"fn":1261,"description":1262,"org":1263,"tags":1264,"stars":23,"repoUrl":24,"updatedAt":1268},"copying-endpoints-across-projects","copy PostHog endpoints across projects","Copy a PostHog endpoint (a saved HogQL\u002Finsight query exposed as an API route) to another project in the same organization, or duplicate it under a new name in the same project. Use when the user wants to duplicate an endpoint, promote an endpoint from staging to production, replicate an endpoint's query\u002Fvariables\u002Ffreshness config in another workspace, or clone an endpoint to iterate on it. Unlike feature flags and experiments, endpoints have NO native cross-project copy tool — this skill covers the read-then-recreate flow (endpoint-get then endpoint-create), the active-project switching it requires, name-collision checks, and the safe defaults (land unmaterialised in the target, verify with endpoint-run). Does not cover editing endpoint versions (see managing-endpoint-versions) or authoring a brand-new endpoint from scratch (see creating-an-endpoint).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1265,1266,1267],{"name":1251,"slug":1252,"type":15},{"name":1209,"slug":1210,"type":15},{"name":9,"slug":8,"type":15},"2026-07-15T05:29:58.442727",{"slug":1270,"name":1270,"fn":1271,"description":1272,"org":1273,"tags":1274,"stars":23,"repoUrl":24,"updatedAt":1286},"creating-ai-subscription","schedule recurring AI-generated PostHog reports","Create a recurring AI-generated PostHog report — schedule a free-text prompt to run on a cron, with the LLM-synthesized markdown delivered to email or Slack on each tick. Use when the user wants a recurring AI summary of X on any cadence (daily, weekly, monthly, yearly) rather than a one-off report. (To attach an AI summary to an existing insight\u002Fdashboard subscription instead of a free-text prompt, see `managing-subscriptions` and its `summary_enabled` option.)\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1275,1276,1279,1280,1283],{"name":1220,"slug":1221,"type":15},{"name":1277,"slug":1278,"type":15},"Email","email",{"name":9,"slug":8,"type":15},{"name":1281,"slug":1282,"type":15},"Reporting","reporting",{"name":1284,"slug":1285,"type":15},"Slack","slack","2026-06-09T07:32:27.935712",{"slug":1288,"name":1288,"fn":1289,"description":1290,"org":1291,"tags":1292,"stars":23,"repoUrl":24,"updatedAt":1296},"creating-an-endpoint","create PostHog API endpoints","Create a PostHog endpoint with the right shape on the first try — covers query kind choice, name conventions, what to expose as variables (HogQL code_name vs insight breakdown), data_freshness_seconds, and whether to materialise on day one. Use when the user says \"create an endpoint\", \"expose this query as an API\", \"turn this insight into an endpoint\", or asks for help structuring a new endpoint. Steers away from common mistakes: materialising a query with cohort breakdowns or compare mode, inline-only variables on a materialised endpoint, unbounded date ranges, ambiguous names.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1293,1294,1295],{"name":1140,"slug":31,"type":15},{"name":1251,"slug":1252,"type":15},{"name":9,"slug":8,"type":15},"2026-06-08T08:08:29.624498",231,{"items":1299,"total":1349},[1300,1307,1313,1320,1327,1334,1342],{"slug":1134,"name":1134,"fn":1135,"description":1136,"org":1301,"tags":1302,"stars":23,"repoUrl":24,"updatedAt":1146},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1303,1304,1305,1306],{"name":1140,"slug":31,"type":15},{"name":1142,"slug":1143,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"slug":1148,"name":1148,"fn":1149,"description":1150,"org":1308,"tags":1309,"stars":23,"repoUrl":24,"updatedAt":1158},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1310,1311,1312],{"name":1140,"slug":31,"type":15},{"name":1155,"slug":1156,"type":15},{"name":9,"slug":8,"type":15},{"slug":1160,"name":1160,"fn":1161,"description":1162,"org":1314,"tags":1315,"stars":23,"repoUrl":24,"updatedAt":1170},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1316,1317,1318,1319],{"name":1155,"slug":1156,"type":15},{"name":1167,"slug":33,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"slug":1172,"name":1172,"fn":1173,"description":1174,"org":1321,"tags":1322,"stars":23,"repoUrl":24,"updatedAt":1183},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1323,1324,1325,1326],{"name":1155,"slug":1156,"type":15},{"name":1167,"slug":33,"type":15},{"name":1180,"slug":1181,"type":15},{"name":9,"slug":8,"type":15},{"slug":1185,"name":1185,"fn":1186,"description":1187,"org":1328,"tags":1329,"stars":23,"repoUrl":24,"updatedAt":1196},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1330,1331,1332,1333],{"name":1191,"slug":1192,"type":15},{"name":21,"slug":22,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"slug":1198,"name":1198,"fn":1199,"description":1200,"org":1335,"tags":1336,"stars":23,"repoUrl":24,"updatedAt":1212},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1337,1338,1339,1340,1341],{"name":1140,"slug":31,"type":15},{"name":1205,"slug":1206,"type":15},{"name":13,"slug":14,"type":15},{"name":1209,"slug":1210,"type":15},{"name":9,"slug":8,"type":15},{"slug":1214,"name":1214,"fn":1215,"description":1216,"org":1343,"tags":1344,"stars":23,"repoUrl":24,"updatedAt":1229},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1345,1346,1347,1348],{"name":1220,"slug":1221,"type":15},{"name":1223,"slug":1224,"type":15},{"name":9,"slug":8,"type":15},{"name":1227,"slug":1228,"type":15},61]