@posthog/cli 0.7.34 → 0.8.1

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,17 @@
1
1
  # posthog-cli
2
2
 
3
+ ## 0.8.1 — 2026-07-06
4
+
5
+ ### Patch changes
6
+
7
+ - [d57bdcce6d](https://github.com/PostHog/posthog/commit/d57bdcce6dc77adde629de5ffbbad10a6a99b850) Capture CLI errors with PostHog telemetry — Thanks @hpouillot!
8
+
9
+ ## 0.8.0 — 2026-07-03
10
+
11
+ ### Minor changes
12
+
13
+ - [066d914497](https://github.com/PostHog/posthog/commit/066d9144970955eaf366ff2a8be818460c6ad759) `symbol-sets upload` now also accepts Apple `.dSYM` bundles, packaging them through the same path as `dsym upload` (uppercase UUID chunk_ids, `AppleDsym` container). A single `posthog-cli symbol-sets upload --directory <dir>` run uploads both Linux ELF debug symbols and macOS dSYMs, so native symbol uploads no longer need a different command per platform. The dSYM branch shells out to `dwarfdump` (Xcode, macOS-only); when it is unavailable the bundle is reported and skipped while ELF symbols in the same directory still upload. The standalone `dsym upload` command is unchanged. — Thanks @cat-ph!
14
+
3
15
  ## 0.7.34 — 2026-06-30
4
16
 
5
17
  ### Patch changes
package/README.md CHANGED
@@ -32,6 +32,18 @@ These variables can also be loaded from a dotenv-style file via `--dotenv-file <
32
32
 
33
33
  Full precedence: CLI args → process env → `--dotenv-file` → `~/.posthog/credentials.json` (from `posthog-cli login`).
34
34
 
35
+ ## Uploading native debug symbols
36
+
37
+ `posthog-cli symbol-sets upload --directory <dir>` scans a directory for native debug symbols and uploads them so PostHog can symbolicate native stack frames.
38
+ A single command handles both desktop/server formats:
39
+
40
+ - **Linux (ELF):** executables, shared libraries, and `objcopy --only-keep-debug` companions that carry a GNU build id. This branch is cross-platform.
41
+ - **macOS (Apple `.dSYM`):** dSYM bundles are packaged through the same path as `posthog-cli dsym upload`. That path shells out to `dwarfdump` (bundled with Xcode), so it only runs on macOS — if `dwarfdump` is missing, the bundle is reported and skipped while any ELF symbols in the same directory still upload.
42
+
43
+ Pass `--include-source` to bundle the referenced source files for richer context around frames.
44
+
45
+ The standalone `posthog-cli dsym upload` command is unchanged and still recommended for dSYM-only Xcode build phases, where it also reads release and version metadata from each bundle's `Info.plist`.
46
+
35
47
  ## Skipping uploads (dry run)
36
48
 
37
49
  Pass `--dry-run` before the subcommand (`posthog-cli --dry-run hermes upload ...`), or set `POSTHOG_CLI_DRY_RUN=true`, to turn the upload commands — `sourcemap`, `dsym`, `hermes`, and `proguard` — into a no-op.
@@ -51,6 +63,8 @@ Commands require different API scopes. Make sure to set these scopes on your per
51
63
  | ----------------------------- | ------------------------------------------ |
52
64
  | `query` | `query:read` |
53
65
  | `sourcemap` | `error_tracking:write` |
66
+ | `symbol-sets` | `error_tracking:write` |
67
+ | `dsym` | `error_tracking:write` |
54
68
  | `exp endpoints list/get/pull` | `endpoint:read` |
55
69
  | `exp endpoints push` | `endpoint:write`, `insight_variable:write` |
56
70
  | `exp endpoints run` | `query:read` |