splithub 0.4.2 → 0.4.3

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.
Files changed (2) hide show
  1. package/README.md +38 -3
  2. package/package.json +23 -4
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # splithub
2
2
 
3
- A/B testing for your app in one command. Run it without arguments and it walks you through; add flags and `--json` when a coding agent runs it.
3
+ Experiments and web analytics for your app, from one command. Run it without arguments and it walks you through; add flags and `--json` when a coding agent runs it.
4
4
 
5
5
  ```bash
6
6
  npx splithub # menu: set up, connect, create, results, start/pause, push — step by step
@@ -15,6 +15,40 @@ npx splithub results hero-title # cloud: verdict, lift, P(beat), p-valu
15
15
  npx splithub plan --baseline 0.05 --mde 0.1 # visitors a test needs (asks SplitHub Cloud, no account needed)
16
16
  npx splithub report # Markdown for a PR comment (the `ci init` workflow posts it)
17
17
  npx splithub doctor # checks config, provider, middleware, route, code references, endpoint
18
+ npx splithub ship hero-title --keep direct # keep the winner in your code, remove the experiment
19
+ npx splithub ci init # GitHub workflow: checks on PRs, results as a PR comment
20
+ ```
21
+
22
+ Results go deeper in SplitHub Cloud: `--by country` (lift per segment), `--timeline`, `--events` (every event
23
+ per variant), `--filter device=mobile --from 2026-10-01` (a slice), `--export` for CSV.
24
+
25
+ ## Analytics
26
+
27
+ One `track()` feeds both: the analytics reports and every experiment that measures that event.
28
+
29
+ ```bash
30
+ npx splithub analytics connect # pick or create a property and name it on your provider (or get the sh.js tag)
31
+ npx splithub analytics # every property, last 30 days
32
+ npx splithub analytics sh-x1h78w --by source --compare # also page, channel, country, device, event, goal, variant…
33
+ npx splithub analytics funnel sh-x1h78w --steps "page:/,event:Signup,goal:paid" --within 7d
34
+ npx splithub analytics funnels sh-x1h78w --save Signup --steps "page:/,goal:signup" # saved for the team
35
+ npx splithub analytics funnel sh-x1h78w --funnel Signup # run a saved funnel
36
+ npx splithub analytics paths sh-x1h78w --page /pricing # where visitors go next (--prev: where they came from)
37
+ npx splithub analytics retention sh-x1h78w # who comes back, per weekly cohort
38
+ npx splithub analytics realtime sh-x1h78w # who is on the site now
39
+ npx splithub analytics segments --save "Paid" channel="Paid Search" # saved filters; any report takes --segment Paid
40
+ npx splithub analytics export sh-x1h78w --by page > pages.csv
41
+ ```
42
+
43
+ Every report takes `--days 7` or `--from --to`, `--filter country=DE` and `--json`.
44
+
45
+ ## Notes, links, alerts
46
+
47
+ ```bash
48
+ npx splithub notes add "Launched the new pricing page" --kind win # shows on every chart
49
+ npx splithub links create https://example.com/spring --slug spring # short link with click counts
50
+ npx splithub alerts add winner --experiment hero-title # also srm, traffic_drop, goal_silent, usage…
51
+ npx splithub domains set property sh-x1h78w example.com # only these sites may send events
18
52
  ```
19
53
 
20
54
  ## Where results come from
@@ -24,8 +58,9 @@ npx splithub doctor # checks config, provider, middleware,
24
58
  | `self` | your app's endpoint on the local dev server (`localhost:3000` for Next.js, `5173` for Vite) or `--url` / `SPLITHUB_URL` | `--token` / `SPLITHUB_ADMIN_TOKEN` when the handler has `adminToken` |
25
59
  | `cloud` | `https://go.splithub.io/v1` (or `--api` / `SPLITHUB_API`) | project API key: `--token sk_...`, `SPLITHUB_API_KEY`, or the key saved by `splithub login` |
26
60
 
27
- Self-hosted reads are raw numbers per variant: visitors, conversions, rate, revenue. Verdicts,
28
- data-quality stars, recommendations and sample-size planning run in SplitHub Cloud.
61
+ Self-hosted reads are raw numbers: visitors, conversions, rate and revenue per variant, and counts of
62
+ pages and events per property. Verdicts, data-quality stars, recommendations, sample-size planning and the
63
+ analytics reports (funnels, paths, retention, segments) run in SplitHub Cloud.
29
64
 
30
65
  `init` and `skills` fetch the latest agent skills from SplitHub Cloud and fall back to the copies
31
66
  bundled with the CLI when it can't be reached.
package/package.json CHANGED
@@ -1,7 +1,26 @@
1
1
  {
2
2
  "name": "splithub",
3
- "version": "0.4.2",
4
- "description": "A/B testing for your app in one command. Create a test, start it, read a plain verdict. Works for you and for your coding agent.",
3
+ "version": "0.4.3",
4
+ "description": "Experiments and web analytics for your app in one command: create an A/B test, read a plain verdict, check traffic, funnels and retention. Works for you and for your coding agent.",
5
+ "keywords": [
6
+ "splithub",
7
+ "ab-testing",
8
+ "a-b-testing",
9
+ "experiments",
10
+ "split-testing",
11
+ "analytics",
12
+ "web-analytics",
13
+ "product-analytics",
14
+ "funnels",
15
+ "mcp",
16
+ "ai-agents",
17
+ "cli",
18
+ "claude-code",
19
+ "cursor",
20
+ "conversion-rate-optimization",
21
+ "retention",
22
+ "feature-experiments"
23
+ ],
5
24
  "license": "MIT",
6
25
  "repository": {
7
26
  "type": "git",
@@ -23,8 +42,8 @@
23
42
  "dependencies": {
24
43
  "@clack/prompts": "^0.9.1",
25
44
  "jiti": "^2.4.2",
26
- "@splithub/core": "0.4.2",
27
- "@splithub/node": "0.4.2"
45
+ "@splithub/core": "0.4.3",
46
+ "@splithub/node": "0.4.3"
28
47
  },
29
48
  "devDependencies": {
30
49
  "@types/node": "^22.13.0",