PostHog Slack app commands and limitations
Contents
The full set of commands @PostHog accepts, in the same order it lists them when you run @PostHog help:
| Command | What it does |
|---|---|
@PostHog <task description> | Create a task for the agent to work on |
@PostHog rules list | Show all routing rules |
@PostHog rules add "description" org/repo | Add a routing rule |
@PostHog rules add "description" | Add a routing rule (pick repo from list) |
@PostHog rules remove <number(s)> | Remove routing rules by number (e.g. remove 1 or remove 1,2) |
@PostHog project | Show which PostHog project your mentions route to in this workspace |
@PostHog project <id> | Set the PostHog project your mentions route to in this workspace |
@PostHog project workspace <id> | Set the workspace-wide default project (Slack admins/owners only) |
@PostHog help | Show the command list |
For repo selection, the bot checks routing rules first. If nothing matches and you have multiple repos, it opens the in-thread picker. If you only have one repo connected, the task runs against it directly. The project commands only matter if your Slack workspace is connected to multiple PostHog projects.
See Pick a project.
Routing rules
Routing rules let you map a mention's content to a specific repo so the agent doesn't have to ask. A rule has a free-text description that's matched against the mention and an org/repo target it routes to:
When several rules match, the first one in rules list wins. Use @PostHog rules remove 1,2 to drop rules you no longer want; numbers correspond to the positions printed by rules list.
Limitations
Before you lean on the Slack app, here's a list of things to know:
- Ephemeral sandbox. Each task runs in a fresh sandbox that lives roughly six hours. Long iterations need re-prompting once it recycles.
- Personal GitHub auth is per user. Every teammate who wants to ship a PR has to connect their own GitHub once. First-time setup has known rough edges.
- Text input only. The agent can't read images yet – paste descriptions instead of screenshots.
- DMs coming soon. The bot doesn't respond in direct messages yet. For now, add it to a private channel of one if you want a quiet space.
- 500-repo cap on the picker. If your team's GitHub install exposes more than 500 repos, the list is truncated. Add a routing rule for repos that fall off the end.
- Workflow timeouts. A single mention has a 10-minute workflow timeout; the repo picker times out after 15 minutes.
- Behavior is still moving. Prompt construction and review-bot trust heuristics are being actively iterated. Expect shifts between beta builds.