@posthog/cli 0.7.22 → 0.7.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # posthog-cli
2
2
 
3
+ ## 0.7.24 — 2026-06-16
4
+
5
+ ### Patch changes
6
+
7
+ - [10af01f66f](https://github.com/PostHog/posthog/commit/10af01f66fad9b230ca925fe4753f6361cd4ca4a) Refresh master before preparing CLI releases — Thanks @cat-ph!
8
+ - [ace786f67b](https://github.com/PostHog/posthog/commit/ace786f67bd4d0360bd79e531cfce2d1f3af9bef) Fix API CLI bundle packaging and lookup — Thanks @cvolzer3!
9
+
10
+ ## 0.7.23 — 2026-06-15
11
+
12
+ ### Patch changes
13
+
14
+ - [8addff91dd](https://github.com/PostHog/posthog/commit/8addff91ddecd46fe135f51403f6bd3c8b36b7b5) Add agentic API tools — Thanks @cvolzer3!
15
+
3
16
  ## 0.7.22 — 2026-06-09
4
17
 
5
18
  ### Patch changes
package/LICENSE CHANGED
@@ -1,4 +1,4 @@
1
- Copyright (c) 2020-2025 PostHog Inc.
1
+ Copyright (c) 2020-2026 PostHog Inc.
2
2
 
3
3
  Portions of this software are licensed as follows:
4
4
 
package/README.md CHANGED
@@ -55,3 +55,41 @@ Commands require different API scopes. Make sure to set these scopes on your per
55
55
  | `exp endpoints push` | `endpoint:write`, `insight_variable:write` |
56
56
  | `exp endpoints run` | `query:read` |
57
57
  | `exp tasks` | `task:read` |
58
+
59
+ ## Agent-first API tools
60
+
61
+ `posthog-cli api` exposes PostHog's MCP tool catalog through a shell-friendly interface for coding agents:
62
+
63
+ ```bash
64
+ posthog-cli api --agent-help
65
+ posthog-cli api search feature-flag
66
+ posthog-cli api info feature-flag-get-all
67
+ posthog-cli api schema query-trends series
68
+ posthog-cli api call --json feature-flag-get-all '{"limit":5}'
69
+ posthog-cli api call --dry-run feature-flags-bulk-delete-create '{"ids":[123]}'
70
+ posthog-cli api skill list
71
+ posthog-cli api skill install audit
72
+ posthog-cli api agents-md install
73
+ ```
74
+
75
+ Destructive tools require `--confirm` when executed. Use `--dry-run` before mutations.
76
+
77
+ `posthog-cli api --agent-help` prints the full agent-facing guide — the same exec tool reference the PostHog MCP server serves, rewritten for CLI invocation — so agents can load it into context before interacting with PostHog APIs.
78
+
79
+ ### Agent steering instructions
80
+
81
+ Install the PostHog CLI steering instructions into the agent instructions file for your project:
82
+
83
+ ```bash
84
+ posthog-cli api agents-md install
85
+ ```
86
+
87
+ By default this updates `AGENTS.md` in the current directory. If your agent reads a different instructions file, pass it explicitly:
88
+
89
+ ```bash
90
+ posthog-cli api agents-md install --path path/to/AGENTS.md
91
+ ```
92
+
93
+ The installed instructions come from the shared snippet at [`services/mcp/src/cli/agents-md-snippet.md`](../services/mcp/src/cli/agents-md-snippet.md), so the installer and this README point at the same source of truth.
94
+
95
+ The snippet is written as a `<posthog>...</posthog>` block. Rerunning the install replaces the existing block in place, so upgrading the CLI and reinstalling refreshes stale instructions without duplicating them.
package/lib/.gitignore ADDED
@@ -0,0 +1,2 @@
1
+ *
2
+ !.gitignore