Set up the PostHog Slack app

Head to the Slack integration page in PostHog and click Add to Slack. Approve the requested scopes – you'll need to be a project admin to install.

To talk to the bot in a channel, @-mention it – Slack will prompt you to invite it – or invite it explicitly with /invite @PostHog. When it joins a channel it posts a short greeting with example prompts. When new teammates join your Slack workspace, they get a welcome DM from the bot introducing itself and what it can do. You can also skip channels entirely and DM the bot directly.

The first time the bot sees a mention, it matches your Slack email to your PostHog account, so make sure you're signed in to the same org on both sides.

A personal GitHub integration is required for the coding agent to run. Without one, the bot refuses to start any repo-bound task and replies in-thread:

I can't start this task yet – you haven't connected your personal GitHub. Connect it so I can open the pull request as you, then mention me again.

This is a hard block on the whole task, not just the PR step – the agent doesn't plan, edit, or run anything until you've connected GitHub. Each teammate who wants to ship code connects their own account at Settings → Personal integrations and clicks Connect GitHub. You can connect multiple accounts or organizations – the agent uses them for repo access, commit attribution, and pull request authorship.

PRs can't be authored under the bot itself – the agent always commits and opens PRs as whichever teammate triggered the task.

If you start a task before connecting, the agent stops and posts a Connect GitHub button in the thread. Click it, finish the OAuth flow, and re-mention the bot – the task picks up where it left off.

A single Slack workspace can be connected to more than one PostHog project. When that happens, the bot won't guess which project your mention belongs to – it asks you to pick one first:

This Slack workspace is connected to multiple PostHog projects:

1. Acme · Production (id 42)
2. Acme · Staging (id 7)

Use @PostHog project <id> to pick one – that also saves it as your default.

Pick a project once and the bot remembers it for you across channels and threads in this workspace.

The same commands are available as the /posthog slash command (e.g. /posthog project <id>). Unlike an @-mention, a slash command is visible only to you, so you can change your routing without posting a message everyone in the channel sees. In a DM you drop the mention entirely: project <id>. You can also manage your personal default and the workspace default from the App Home tab under Project routing.

The bot resolves a target with this precedence: thread context (continuing an existing task) → your personal default → workspace-wide default (set with @PostHog project workspace <id> by a Slack admin) → the only connected project → picker. Personal defaults always win over the workspace fallback, so each teammate can route their own mentions independently.

If your workspace is only connected to a single PostHog project, you can skip this step – the bot routes there automatically.

Once both integrations are connected and (if needed) you've picked a project, you're ready to start a task. The full command reference covers everything @PostHog accepts.