PostHog Code settings
Contents
PostHog Code surfaces a lot of configuration that you'd normally manage through a CLI or config files. This page calls out the highlights, not every toggle.
Notifications
Choose how PostHog Code gets your attention when an agent finishes or needs input: push notifications, dock badge, dock bounce, or a completion sound effect. There are 11 sounds to pick from and a volume slider with an inline test button.
Custom instructions
A freeform text field injected into every agent session. Use it for things like "always write tests" or "prefer functional patterns."
MCP servers
A built-in marketplace for discovering, installing, and managing MCP servers. Per-tool approval policies let you approve, block, or require confirmation for individual tools.
Environments
Local environments define setup scripts that run when a new worktree is created, so the agent lands in a project that's already installed and ready. They're stored as TOML and committable, so your team shares the same config.
Cloud environments control network access rules and environment variables for remote sandbox sessions.
Worktrees
Configure auto-suspension to reclaim disk space from stale worktrees. Set a max active count and an inactivity threshold. Suspended worktrees restore on demand.
Self-driving
The Self-driving tab configures the same self-driving setup you manage in the PostHog web app – it's one shared configuration, not a separate copy for the desktop app. From here you can:
- Connect GitHub and toggle which signal sources feed your inbox. These are the same sources you'd configure in the web UI.
- Set a priority threshold (P0 through P4) that controls when the agent auto-starts tasks assigned to you.
- Choose where report notifications go:
- Default notification channel – where every report is posted for the whole team.
- Notify me directly – when you're a suggested reviewer, get pinged in your own channel instead of the team's default. Reviewers who set their own channel are notified there.
You can configure the same signal sources from the Agents tab in PostHog Code (the same nav level as Command Center and your tasks) or from the web app. It's all one setup, so a change in any of these places applies everywhere.
Task defaults
New tasks start in Plan mode by default. You can change this to remember the last-used mode instead. There's also a keep-awake toggle that prevents macOS from sleeping while an agent is running.
Fun stuff
- Hedgehog mode releases a PostHog hedgehog that walks around your screen
- Sound effects range from professional to completely unhinged