@great-arrow/cli 0.1.3 → 0.1.7
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/README.md +35 -5
- package/dist/index.js +12754 -2403
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -8,24 +8,34 @@ Terminal-based access to the Great Arrow Digital platform — memory management,
|
|
|
8
8
|
npm install -g @great-arrow/cli
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Requires **Node.js
|
|
11
|
+
Requires **Node.js 24+**.
|
|
12
12
|
|
|
13
13
|
## Authentication
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
# Browser
|
|
16
|
+
# Browser login (loopback OAuth + PKCE). Opens your browser, captures the
|
|
17
|
+
# callback locally, and stores a refreshable credential — no copy-paste.
|
|
18
|
+
# The session refreshes itself; you won't be asked to log in again until the
|
|
19
|
+
# refresh token expires.
|
|
17
20
|
gad login
|
|
18
21
|
|
|
19
|
-
#
|
|
22
|
+
# If a browser can't be opened (SSH/remote), print the URL to open manually
|
|
23
|
+
gad login --no-browser
|
|
24
|
+
|
|
25
|
+
# Direct personal token (CI/CD, headless). Stored as-is; no auto-refresh.
|
|
20
26
|
gad login --token gad_xxxxx
|
|
21
27
|
|
|
22
|
-
# Check who you are
|
|
28
|
+
# Check who you are (shows auth type + access-token expiry)
|
|
23
29
|
gad whoami
|
|
24
30
|
|
|
25
|
-
#
|
|
31
|
+
# Revoke the session server-side and remove stored credentials
|
|
26
32
|
gad logout
|
|
27
33
|
```
|
|
28
34
|
|
|
35
|
+
Credentials live in your OS keychain (Keychain Access / libsecret / Credential
|
|
36
|
+
Vault). OAuth access tokens are short-lived and refreshed automatically; `GAD_TOKEN`
|
|
37
|
+
in the environment always takes precedence for CI.
|
|
38
|
+
|
|
29
39
|
Tokens are stored in the OS keychain (macOS Keychain / Windows Credential Manager / Linux Secret Service). You can also set `GAD_TOKEN` as an environment variable.
|
|
30
40
|
|
|
31
41
|
## Commands
|
|
@@ -91,6 +101,26 @@ gad mcp install gemini
|
|
|
91
101
|
`gad mcp install codex` writes Codex's native `~/.codex/config.toml` server
|
|
92
102
|
entry and stores the bearer token in `~/.codex/.env`.
|
|
93
103
|
|
|
104
|
+
#### Keeping local MCP installs current
|
|
105
|
+
|
|
106
|
+
Great Arrow checks local MCP/CLI versions from the headers and user-agent hints
|
|
107
|
+
sent by installed configs, the `gad` CLI, and the stdio proxy. When a local
|
|
108
|
+
agent is stale, the recommended path for users is **Account → Connections** in
|
|
109
|
+
the web app, then the agent's **Update**, **Update now**, or **Check setup**
|
|
110
|
+
button. That flow provides client-specific repair steps without requiring the
|
|
111
|
+
user to understand MCP config files.
|
|
112
|
+
|
|
113
|
+
Terminal fallback:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
npm install -g @great-arrow/cli@latest
|
|
117
|
+
gad doctor
|
|
118
|
+
gad mcp install codex # replace codex with claude, cursor, kiro, or gemini
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Use `gad doctor` after repair to confirm API access, token metadata capture,
|
|
122
|
+
and MCP reachability.
|
|
123
|
+
|
|
94
124
|
### Agents
|
|
95
125
|
|
|
96
126
|
```bash
|