Rebuild Slack app docs and promote to a top-level docs section by VojtechBartos · Pull Request #17085 · PostHog/posthog.com

VojtechBartos · 2026-05-28T08:34:33Z

Summary

Full rebuild and reorganization of the Slack app docs. The previous single page at /docs/posthog-code/slack documented behavior that no longer exists (the removed default repo commands) and missed everything shipped in PostHog/posthog#60249 (per-user project routing in multi-integration Slack workspaces).

Content

Replaces the deprecated default repo set/show/clear commands with the actual supported set, including the new @PostHog project / project <id> commands from #60249 — listed in the same order the bot prints them with @PostHog help.
Documents the personal GitHub integration as mandatory for the coding agent (not a soft fallback) with the exact in-thread error the bot posts, plus a callout for the GitHub OAuth "Save button disabled" workaround.
Adds a Pick a project section explaining the new multi-integration workspace routing (thread → personal default → workspace default → sole candidate → picker).
Adds a Limitations section: ~6h sandbox lifetime, single-author follow-ups, text-only input, no DMs, 500-repo picker cap, workflow timeouts (10 min mention / 15 min picker).
Adds a Pricing page noting that agent activity bills through PostHog AI credits per the launch RFC (requests-for-comments-public#548), while subscriptions/unfurl/CDP destinations remain free.

Structure

Moves docs from /docs/posthog-code/slack to /docs/slack-app/, matching the marketing landing page URL and the convention used by other PostHog surfaces (/docs/vscode-extension/, /docs/cmd-k/, /docs/toolbar/). Redirect added in vercel.json.
Promotes the Slack app to a top-level docs menu entry alongside PostHog AI / PostHog Code, with an IconAtSign icon (no IconSlack ships in @posthog/icons).
Splits the doc into four pages: Overview, Setup, Commands, Pricing — each deep-linkable from the product page (PostHog Slack App Product Page #17077) and other docs.
Removes the duplicate Slack entry from Product OS → "Tools and features" so there's one source of truth for the nav.

Screenshots

Uploaded the Slack integration panel and the personal GitHub integration screenshots to Cloudinary; both render in the Setup page at 800px-normalized widths.

Test plan

Preview renders all four pages: /docs/slack-app, /docs/slack-app/setup, /docs/slack-app/commands, /docs/slack-app/pricing.
/docs/posthog-code/slack redirects to /docs/slack-app.
Top-level "Slack app" entry appears in the docs nav with the @ icon, between PostHog Code and Workflows.
All four nav children resolve (Overview, Setup, Commands, Pricing).
Internal links resolve: /code, /slack-app, /docs/libraries/slack#link-unfurling, /docs/cdp/destinations/slack, /docs/posthog-ai/pricing, /docs/slack-app/setup#pick-a-project-multi-integration-workspaces.
Both app.posthog.com setting deep-links open the right panel.

github-actions · 2026-05-28T08:34:48Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	May 29, 2026 11:19AM

github-actions · 2026-05-28T08:35:33Z

Vale prose linter → found 34 errors, 12 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/posthog-code/index.mdx — 0 errors, 3 warnings, 0 suggestions

Line	Severity	Message	Rule
36:5	warning	'Worktree' is a possible misspelling.	`PostHogBase.Spelling`
50:99	warning	'enricher' is a possible misspelling.	`PostHogBase.Spelling`
92:116	warning	'repo's' is a possible misspelling.	`PostHogBase.Spelling`

contents/docs/slack-app/commands.mdx — 2 errors, 1 warnings, 0 suggestions

Line	Severity	Message	Rule
19:307	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
39:54	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
40:5	warning	'DMs' is a possible misspelling.	`PostHogBase.Spelling`

contents/docs/slack-app/index.mdx — 14 errors, 3 warnings, 0 suggestions

Line	Severity	Message	Rule
7:79	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
11:172	warning	'sandboxed' is a possible misspelling.	`PostHogBase.Spelling`
11:331	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
19:96	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
29:109	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
29:113	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
29:128	warning	Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept.	`PostHogBase.ProductNames`
41:133	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
49:100	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
66:197	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
70:33	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
71:39	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
72:37	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
73:43	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
74:24	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
75:56	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
76:71	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`

contents/docs/slack-app/pricing.mdx — 6 errors, 0 warnings, 0 suggestions

Line	Severity	Message	Rule
7:113	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
11:160	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
11:220	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
17:52	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
26:65	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
30:301	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`

contents/docs/slack-app/setup.mdx — 12 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
10:266	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
18:45	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
18:82	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
22:23	warning	'OAuth' is a possible misspelling.	`PostHogBase.Spelling`
22:271	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
30:31	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
32:62	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
32:388	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
42:156	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
42:187	warning	'OAuth' is a possible misspelling.	`PostHogBase.Spelling`
46:130	warning	'OAuth' is a possible misspelling.	`PostHogBase.Spelling`
46:163	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
50:152	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
53:25	warning	Use 'ID' instead of 'id'.	`Vale.Terms`
54:22	warning	Use 'ID' instead of 'id'.	`Vale.Terms`
56:43	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
67:91	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`

…on tip

…ement

Promote the Slack app docs from /docs/posthog-code/slack to /docs/slack-app, matching the marketing landing page URL and the convention used by other PostHog surfaces (vscode-extension, toolbar, cmd-k). Adds a redirect from the old path, updates the nav entry and the cross-link in posthog-code/index.mdx, and moves the local screenshots to /images/docs/slack-app/.

tatoalo · 2026-05-29T09:59:43Z

+- **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.
+- **Single-author follow-ups.** Only the person who started a task can steer it. Colleagues' messages become context, not instructions.
+- **Text input only.** The agent can't read images yet - paste descriptions instead of screenshots.
+- **No DMs.** The bot doesn't respond in direct messages. Add it to a private channel of one if you want a quiet space.


This we can easily support via slack agents, it's just a couple of scope changes and we are there. We can maybe point to it coming soon?

tatoalo · 2026-05-29T10:00:27Z

+
+| Emoji | What it means |
+|---|---|
+| 🌱 `:seedling:` | Saw your mention and is spinning up a new task |


not sure if worth it but saw we shipped this PostHog/posthog#60469 so maybe we can already update that?

reverted 😆 PostHog/posthog#60650

tatoalo · 2026-05-29T10:01:20Z

+| 🌱 `:seedling:` | Saw your mention and is spinning up a new task |
+| 👀 `:eyes:` | Forwarding a follow-up to the running agent, or resuming a previous run |
+| 🦔 `:hedgehog:` | The agent finished and posted its reply in the thread |
+| ❌ `:x:` | Something went wrong – usually the sandbox stopped before the message could be delivered |


let's remove the em-dash here, also that ❌ really is generic so maybe worth removing the "sandbox stopped" guess since we catch everything in there

tatoalo · 2026-05-29T10:02:05Z

+    alt="The Slack integration section in project settings, with the Add to Slack button"
+/>
+
+To talk to the bot in a channel, invite it: `/invite @PostHog`. The first time it 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 first mention would also work right? (meaning, w/out explicit invite command

tatoalo · 2026-05-29T10:02:27Z

+
+<CalloutBox icon="IconWarning" title="Reconnect if you installed before 2026-05-04" type="caution">
+
+The bot picked up new OAuth scopes on 2026-05-04 (`app_mentions:read`, `users:read`, `users:read.email`, `chat:write`, `channels:history`, `groups:history`, `reactions:write`). If your workspace was connected before that date, head back to **Add to Slack** and re-approve - otherwise the bot will fail with a missing-scope error on the next mention.


can we automate this/trigger re-auth?

tbh haven't checked, going to investigate

VojtechBartos added 11 commits May 29, 2026 09:47

Rebuild Slack app docs

9f1d4b5

Add screenshot placeholders for Slack and GitHub setup

53db58e

Update setup prose to match actual UI labels and add GitHub save-butt…

73b8e11

…on tip

Link Personal integrations page directly

8ee0743

Link Slack integration settings deep link

d9fdc35

Document multi-integration project routing and personal GitHub requir…

bf348ca

…ement

Add Slack and personal GitHub setup screenshots

6670abc

Mark Slack app as beta instead of alpha

c5c768c

Swap local Slack/GitHub setup screenshots for Cloudinary URLs

2ed85c2

Promote Slack app to a top-level nav item alongside VS Code extension

d5e7d2e

VojtechBartos force-pushed the vojtab/slack-app-docs branch from de372ac to d5e7d2e Compare May 29, 2026 07:53

VojtechBartos added 4 commits May 29, 2026 10:22

Promote Slack app to a top-level docs menu entry

10243e9

Add pricing page for the Slack app

903bb52

Use IconAtSign for the Slack app nav entry

5f51ee2

Split Slack app docs into Overview, Setup, and Commands sections

2a7275d

VojtechBartos changed the title ~~Rebuild PostHog Code Slack app docs~~ Rebuild Slack app docs and promote to a top-level docs section May 29, 2026

tatoalo reviewed May 29, 2026

View reviewed changes

Address review feedback on Slack app docs

8a84c5c

VojtechBartos self-assigned this May 29, 2026

VojtechBartos requested review from annikaschmid and cleo-pleurodon May 29, 2026 10:36

VojtechBartos marked this pull request as ready for review May 29, 2026 10:36

Revert seedling row: posthog#60469 was reverted

6e80f84

cleo-pleurodon mentioned this pull request May 29, 2026

Posthog code/slack app cross links #17132

Open

5 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Rebuild Slack app docs and promote to a top-level docs section#17085

Rebuild Slack app docs and promote to a top-level docs section#17085
VojtechBartos wants to merge 17 commits into
masterfrom
vojtab/slack-app-docs

VojtechBartos commented May 28, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 28, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 28, 2026 •

edited

Loading

Uh oh!

tatoalo May 29, 2026

Uh oh!

tatoalo May 29, 2026

Uh oh!

tatoalo May 29, 2026

Uh oh!

VojtechBartos May 29, 2026

Uh oh!

tatoalo May 29, 2026

Uh oh!

tatoalo May 29, 2026

Uh oh!

tatoalo May 29, 2026

Uh oh!

VojtechBartos May 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		<CalloutBox icon="IconWarning" title="Reconnect if you installed before 2026-05-04" type="caution">

		The bot picked up new OAuth scopes on 2026-05-04 (`app_mentions:read`, `users:read`, `users:read.email`, `chat:write`, `channels:history`, `groups:history`, `reactions:write`). If your workspace was connected before that date, head back to Add to Slack and re-approve - otherwise the bot will fail with a missing-scope error on the next mention.

Conversation

VojtechBartos commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Content

Structure

Screenshots

Test plan

Uh oh!

github-actions Bot commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy preview

Uh oh!

github-actions Bot commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

VojtechBartos commented May 28, 2026 •

edited

Loading

github-actions Bot commented May 28, 2026 •

edited

Loading

github-actions Bot commented May 28, 2026 •

edited

Loading