Skip to content

: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.

2.7 KB
Raw Blame

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.

App and package guides