ai-plugin

Name: ai-plugin
Author: posthog

byposthog· 1 MCP server

Stars

Forks

How to install ai-plugin?

posthog/ai-plugin

$git clone https://github.com/posthog/ai-plugin

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install ai-plugin by running `git clone https://github.com/posthog/ai-plugin`, then use it for the current task and follow its documentation at https://github.com/posthog/ai-plugin.

Files · 1

View on GitHub

README.md

1	# PostHog AI plugin
2
3	Official PostHog plugin for AI clients. Access PostHog products directly from your AI coding tool.
4
5	## Installation
6
7	### Claude Code
8
9	1. Install the plugin:
10	```bash
11	claude plugin install posthog
12	```
13
14	2. Authenticate via OAuth:
15	```bash
16	# Just enter Claude Code anywhere
17	claude
18	# Then, use the /mcp command within Claude, select plugin:posthog:posthog, and press Enter
19	/mcp
20	```
21	Then follow the browser prompts to log into PostHog.
22
23	3. (Optional) Send Claude Code sessions to PostHog LLM Analytics.
24
25	Add to `~/.claude/settings.json` (global) or `.claude/settings.local.json` (per-project):
26	```json
27	{
28	"env": {
29	"POSTHOG_LLMA_CC_ENABLED": "true",
30	"POSTHOG_API_KEY": "phc_...",
31	"POSTHOG_HOST": "https://eu.i.posthog.com"
32	}
33	}
34	```
35
36	Both `POSTHOG_LLMA_CC_ENABLED=true` and `POSTHOG_API_KEY` are required. Sessions are sent when Claude Code exits. Set `POSTHOG_LLMA_PRIVACY_MODE=true` to redact prompt/output content. Add custom properties to all events with `POSTHOG_LLMA_CUSTOM_PROPERTIES` (JSON string, e.g. `'{"ai_product": "my-app"}'`). Set `POSTHOG_AI_PURPOSE` to declare what the session is doing relative to the repo — documented values are `authoring` and `review`, emitted as `$ai_purpose`. Useful when a harness wraps an agent it can't modify (e.g. a CI job running Claude Code as a reviewer); left unset the property is omitted.
37
38	### Cursor
39
40	Install from the [Cursor Marketplace](https://cursor.com/marketplace) or add manually in Cursor Settings > Plugins.
41
42	### Codex
43
44	1. Add the marketplace:
45	```bash
46	codex plugin marketplace add PostHog/ai-plugin
47	```
48
49	2. Install the plugin from inside Codex:
50	```
51	codex
52	# Then run /plugins, select PostHog, and install
53	/plugins
54	```
55
56	### Gemini CLI
57
58	```bash
59	gemini extensions install https://github.com/PostHog/ai-plugin
60	```
61
62	### Grok
63
64	1. Install the plugin:
65	```bash
66	grok plugin install PostHog/ai-plugin --trust
67	```
68
69	2. Authenticate via OAuth:
70
71	On first use of a PostHog tool, Grok prompts you to authorize in your browser. Log into PostHog to connect.
72
73	## How to develop
74
75	1. Clone and install the plugin:
76	```bash
77	git clone https://github.com/PostHog/ai-plugin
78	claude --plugin-dir ./ai-plugin
79	```
80
81	2. Authenticate via OAuth:
82	```
83	/mcp
84	```
85	Then follow the browser prompts to log into PostHog.
86
87	## Features
88
89	This plugin provides access to 27+ PostHog tools across these categories:
90
91	- Feature flags - Create, update, and manage feature flags
92	- Experiments - Run and analyze A/B tests
93	- Insights - Query analytics and create visualizations
94	- Dashboards - Manage dashboards and add insights
95	- Error tracking - View and debug errors
96	- LLM analytics - Track AI/LLM costs and usage
97	- Documentation - Search PostHog docs
98	- And more
99
100	### Bundled skills
101
102	The plugin also ships 30+ task-specific skills that your AI client loads on demand to follow PostHog best practices — covering HogQL query patterns, experiment creation and lifecycle, feature flags, data warehouse setup and troubleshooting, LLM analytics exploration, session replay diagnostics, and SDK instrumentation. Skills activate automatically when their description matches your request (e.g. "create an experiment", "why isn't my Stripe sync working?", "audit my feature flags"), so you generally don't need to invoke them by name.
103
104	## Example usage
105
106	```
107	> What feature flags do I have?
108	> Create a feature flag called new-onboarding for 50% of users
109
110	> Show me errors from the last 24 hours
111	> Which errors are affecting the most users?
112
113	> How many users signed up this week?
114	> What's the conversion rate for the checkout funnel?
115
116	> Show me all my experiments
117	> What are the results of the checkout-flow experiment?
118
119	> Create a new dashboard called Product Metrics
120	> Add the signup funnel insight to the Growth dashboard
121
122	> What are the responses to the NPS survey?
123	> Create a feedback survey for the checkout page
124
125	> What's my most triggered event?
126	> Show me the top 10 pages by pageviews
127	```
128
129	## Self-hosted
130
131	For self-hosted PostHog instances, set the `POSTHOG_MCP_URL` environment variable to point to your instance:
132
133	```bash
134	export POSTHOG_MCP_URL="https://mcp.your-posthog-instance.com/mcp"
135	```
136
137	## Documentation
138
139	- [PostHog MCP documentation](https://posthog.com/docs/model-context-protocol)
140	- [PostHog API documentation](https://posthog.com/docs/api)
141
142	## License
143
144	MIT

6 picks

Type

ai-plugin

byposthog· 1 MCP server

Stars

Forks

How to install ai-plugin?

posthog/ai-plugin

$git clone https://github.com/posthog/ai-plugin

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install ai-plugin by running `git clone https://github.com/posthog/ai-plugin`, then use it for the current task and follow its documentation at https://github.com/posthog/ai-plugin.

Files · 1

View on GitHub

README.md

1	# PostHog AI plugin
2
3	Official PostHog plugin for AI clients. Access PostHog products directly from your AI coding tool.
4
5	## Installation
6
7	### Claude Code
8
9	1. Install the plugin:
10	```bash
11	claude plugin install posthog
12	```
13
14	2. Authenticate via OAuth:
15	```bash
16	# Just enter Claude Code anywhere
17	claude
18	# Then, use the /mcp command within Claude, select plugin:posthog:posthog, and press Enter
19	/mcp
20	```
21	Then follow the browser prompts to log into PostHog.
22
23	3. (Optional) Send Claude Code sessions to PostHog LLM Analytics.
24
25	Add to `~/.claude/settings.json` (global) or `.claude/settings.local.json` (per-project):
26	```json
27	{
28	"env": {
29	"POSTHOG_LLMA_CC_ENABLED": "true",
30	"POSTHOG_API_KEY": "phc_...",
31	"POSTHOG_HOST": "https://eu.i.posthog.com"
32	}
33	}
34	```
35
36	Both `POSTHOG_LLMA_CC_ENABLED=true` and `POSTHOG_API_KEY` are required. Sessions are sent when Claude Code exits. Set `POSTHOG_LLMA_PRIVACY_MODE=true` to redact prompt/output content. Add custom properties to all events with `POSTHOG_LLMA_CUSTOM_PROPERTIES` (JSON string, e.g. `'{"ai_product": "my-app"}'`). Set `POSTHOG_AI_PURPOSE` to declare what the session is doing relative to the repo — documented values are `authoring` and `review`, emitted as `$ai_purpose`. Useful when a harness wraps an agent it can't modify (e.g. a CI job running Claude Code as a reviewer); left unset the property is omitted.
37
38	### Cursor
39
40	Install from the [Cursor Marketplace](https://cursor.com/marketplace) or add manually in Cursor Settings > Plugins.
41
42	### Codex
43
44	1. Add the marketplace:
45	```bash
46	codex plugin marketplace add PostHog/ai-plugin
47	```
48
49	2. Install the plugin from inside Codex:
50	```
51	codex
52	# Then run /plugins, select PostHog, and install
53	/plugins
54	```
55
56	### Gemini CLI
57
58	```bash
59	gemini extensions install https://github.com/PostHog/ai-plugin
60	```
61
62	### Grok
63
64	1. Install the plugin:
65	```bash
66	grok plugin install PostHog/ai-plugin --trust
67	```
68
69	2. Authenticate via OAuth:
70
71	On first use of a PostHog tool, Grok prompts you to authorize in your browser. Log into PostHog to connect.
72
73	## How to develop
74
75	1. Clone and install the plugin:
76	```bash
77	git clone https://github.com/PostHog/ai-plugin
78	claude --plugin-dir ./ai-plugin
79	```
80
81	2. Authenticate via OAuth:
82	```
83	/mcp
84	```
85	Then follow the browser prompts to log into PostHog.
86
87	## Features
88
89	This plugin provides access to 27+ PostHog tools across these categories:
90
91	- Feature flags - Create, update, and manage feature flags
92	- Experiments - Run and analyze A/B tests
93	- Insights - Query analytics and create visualizations
94	- Dashboards - Manage dashboards and add insights
95	- Error tracking - View and debug errors
96	- LLM analytics - Track AI/LLM costs and usage
97	- Documentation - Search PostHog docs
98	- And more
99
100	### Bundled skills
101
102	The plugin also ships 30+ task-specific skills that your AI client loads on demand to follow PostHog best practices — covering HogQL query patterns, experiment creation and lifecycle, feature flags, data warehouse setup and troubleshooting, LLM analytics exploration, session replay diagnostics, and SDK instrumentation. Skills activate automatically when their description matches your request (e.g. "create an experiment", "why isn't my Stripe sync working?", "audit my feature flags"), so you generally don't need to invoke them by name.
103
104	## Example usage
105
106	```
107	> What feature flags do I have?
108	> Create a feature flag called new-onboarding for 50% of users
109
110	> Show me errors from the last 24 hours
111	> Which errors are affecting the most users?
112
113	> How many users signed up this week?
114	> What's the conversion rate for the checkout funnel?
115
116	> Show me all my experiments
117	> What are the results of the checkout-flow experiment?
118
119	> Create a new dashboard called Product Metrics
120	> Add the signup funnel insight to the Growth dashboard
121
122	> What are the responses to the NPS survey?
123	> Create a feedback survey for the checkout page
124
125	> What's my most triggered event?
126	> Show me the top 10 pages by pageviews
127	```
128
129	## Self-hosted
130
131	For self-hosted PostHog instances, set the `POSTHOG_MCP_URL` environment variable to point to your instance:
132
133	```bash
134	export POSTHOG_MCP_URL="https://mcp.your-posthog-instance.com/mcp"
135	```
136
137	## Documentation
138
139	- [PostHog MCP documentation](https://posthog.com/docs/model-context-protocol)
140	- [PostHog API documentation](https://posthog.com/docs/api)
141
142	## License
143
144	MIT

6 picks

Type

ai-plugin

How to install ai-plugin?

Related

ai-plugin

How to install ai-plugin?

Related