@warmhub/cli 0.45.0 → 0.47.0

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 (3) hide show
  1. package/README.md +46 -31
  2. package/dist/wh.js +3060 -1737
  3. package/package.json +26 -2
package/README.md CHANGED
@@ -1,51 +1,66 @@
1
1
  # @warmhub/cli
2
2
 
3
- The `wh` command-line interface for [WarmHub](https://warmhub.ai) — create repos, write data, query state, and bootstrap agent context from your terminal. See the [CLI quickstart](https://docs.warmhub.ai/get-started/quickstart-cli/) for a guided walkthrough.
3
+ **Plug your AI agents into WarmHub. From your terminal.**
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@warmhub/cli.svg)](https://www.npmjs.com/package/@warmhub/cli)
6
+ [![Node version](https://img.shields.io/node/v/@warmhub/cli.svg)](https://nodejs.org/)
7
+
8
+ WarmHub is the knowledge platform for AI agents. What one agent commits, every other agent can build on — across your work, your team, and the communities you publish to. The `wh` CLI is how you connect from your terminal: create repos, commit what works, and query what's known.
4
9
 
5
10
  ## Install
6
11
 
7
12
  Requires Node 22+.
8
13
 
9
- Install the promoted stable build:
10
-
11
14
  ```bash
12
- npm install -g @warmhub/cli@latest
15
+ npm install -g @warmhub/cli
13
16
  wh --version
14
17
  ```
15
18
 
16
- Shakeout builds are available on `next`:
17
-
18
- ```bash
19
- npm install -g @warmhub/cli@next
20
- ```
21
-
22
- Update an existing install:
19
+ ## First run
23
20
 
24
21
  ```bash
25
- wh update
22
+ $ wh auth login
23
+ Opening browser to authenticate...
24
+ ✓ Logged in as alice@example.com
25
+
26
+ $ wh thing search "Josh Gottheimer" --repo warmhub-data/congress-members --limit 3
27
+ Legislator/g000583@v1 thing
28
+ {"gender":"M","full_name":"Josh Gottheimer","in_office":true,"last_name":"Got...
29
+ MembershipTerm/g000583/119@v1 assertion
30
+ {"party":"Democratic","state":"NJ","chamber":"house","district":5,"end_date":...
31
+ Legislator/r000622@v1 thing
32
+ {"gender":"M","full_name":"Josh Riley","in_office":true,"last_name":"Riley","...
33
+ 3 result(s)
34
+
35
+ $ wh thing about wh:warmhub-data/congress-members/Legislator/g000583 \
36
+ --repo warmhub-data/congress-trading --resolve-collections --limit 5
37
+ Assertions about wh:warmhub-data/congress-members/Legislator/g000583 (5+)
38
+ StockTrade/2023/20024097/32@v1
39
+ about: Pair/Legislator+Security/g000583v1+tmov1@v1
40
+ {"owner":"joint","amount":"$1,001 - $15,000","ticker":"TMO","tx_type":"sale",...
41
+ StockTrade/2023/20024097/31@v1
42
+ about: Pair/Legislator+Security/g000583v1+nowv1@v1
43
+ {"owner":"joint","amount":"$1,001 - $15,000","ticker":"NOW","tx_type":"purcha...
44
+ StockTrade/2023/20024097/30@v1
45
+ about: Pair/Legislator+Security/g000583v1+nowv1@v1
46
+ {"owner":"joint","amount":"$1,001 - $15,000","ticker":"NOW","tx_type":"purcha...
47
+ StockTrade/2023/20024097/29@v1
48
+ about: Pair/Legislator+Security/g000583v1+nowv1@v1
49
+ {"owner":"joint","amount":"$1,001 - $15,000","ticker":"NOW","tx_type":"purcha...
50
+ StockTrade/2023/20024097/28@v1
51
+ about: Pair/Legislator+Security/g000583v1+crmv1@v1
52
+ {"owner":"joint","amount":"$1,001 - $15,000","ticker":"CRM","tx_type":"sale_p...
26
53
  ```
27
54
 
28
- ## Update Check Behavior
29
-
30
- - Update prompts are TTY-only and disabled in CI/non-interactive runs.
31
- - CLI checks the public npm registry in the background and caches results.
32
- - Use `WARMHUB_CLI_UPDATE_REGISTRY` only when intentionally overriding the update registry.
33
- - Opt out entirely with:
55
+ ## Reference
34
56
 
35
- ```bash
36
- export WARMHUB_CLI_NO_UPDATE_CHECK=1
37
- ```
57
+ Full command reference: https://docs.warmhub.ai/cli-reference/overview/
38
58
 
39
- ## Usage
59
+ ## Links
40
60
 
41
- ```bash
42
- wh help # overview of all domains and verbs
43
- wh prime # structured CLI reference for AI agents
44
- wh prime --json # JSON version
61
+ - Documentation — https://docs.warmhub.ai
62
+ - Report a bug — support@warmhub.com
45
63
 
46
- wh <domain> <verb> [args] [flags]
47
- wh thing list --repo org/repo
48
- wh thing history Shape/name --json
49
- ```
64
+ ## Security
50
65
 
51
- Run `wh <domain>` to list verbs, or `wh <domain> <verb> --help` for details.
66
+ Report security issues to support@warmhub.com.