:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
Desktop documentation
Start with the guide that matches the work you are doing. AGENTS.md remains the source of truth when a guide conflicts with an architecture or code rule.
Develop and test
| Guide | Use it for |
|---|---|
| Local development | Connect the desktop app to a local PostHog instance. |
| Architecture | Understand package layers, dependency injection, host boundaries, and feature placement. |
| Code conventions | Follow component, store, hook, styling, logging, and analytics conventions. |
| Testing | Choose and run unit, UI, end-to-end, interactive, and visual tests. |
| Troubleshooting | Resolve common setup, native module, and signing failures. |
Operate and release
| Guide | Use it for |
|---|---|
| Updates | Understand versioning, release tags, and update publishing. |
| Local auto-update testing | Exercise the packaged app's update flow without publishing a release. |
| Announcements | Configure and test remote in-app announcements. |
| Cloud task artifacts | Understand artifact notifications and dismissal behavior. |
Feature references
| Guide | Use it for |
|---|---|
| Inbox report states | Understand dismissal feedback and investigation status. |
| Deep links | Work with posthog-code:// routes and OAuth callbacks. |
| Pi extensions | Understand repository trust and desktop RPC behavior for Pi extensions. |
| Cloud MCP import | Understand importing local MCP configuration into cloud task runs. |
| Cloud MCP relay | Understand the design for relaying local MCP servers to cloud task runs. |
Design records
These documents capture design intent at a point in time. Check the current code and architecture rules before using them as implementation guidance.