@great-arrow/cli 0.1.12 → 0.1.23

package/LICENSE

@@ -1,21 +1,37 @@
-MIT License
-
-Copyright (c) 2026 Great Arrow Digital
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+GREATARROW.AI CLI PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2024-2026 Manito AI (manito.ai). All rights reserved.
+
+The GreatArrow.ai command-line interface, including its source code,
+documentation, and distributed package (the "CLI"), is proprietary software
+owned by Manito AI.
+
+LIMITED USE RIGHT. Subject to the GreatArrow.ai Terms of Service, Manito AI
+grants an authorized GreatArrow.ai user a limited, revocable, non-exclusive,
+non-transferable right to install and execute an unmodified copy of the CLI
+solely to access and use the GreatArrow.ai hosted service.
+
+NO OTHER LICENSE. No right is granted to copy, modify, adapt, translate,
+reverse engineer, create derivative works from, distribute, sublicense, sell,
+host, or use the CLI to provide a competing product or service, except where
+applicable law expressly permits a restriction to be overridden.
+
+THIRD-PARTY COMPONENTS. The CLI incorporates third-party components that
+remain subject to their respective licenses. This license does not limit any
+rights granted directly by those third-party licenses.
+
+TERMINATION. The limited use right ends automatically when the user no longer
+has authorization to use GreatArrow.ai or breaches these terms. On
+termination, the user must stop using and delete the CLI.
+
+NO WARRANTY. THE CLI IS PROVIDED "AS IS" AND "AS AVAILABLE," WITHOUT WARRANTY
+OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY LAW, MANITO AI AND
+ITS AFFILIATES WILL NOT BE LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING FROM OR RELATING TO THE CLI.
+
+The Terms of Service are published at
+https://www.greatarrow.ai/legal/terms. Licensing inquiries:
+legal@greatarrow.ai.

package/README.md

@@ -1,6 +1,6 @@
 # @great-arrow/cli (`gad`)
 
-Terminal-based access to the Great Arrow Digital platform — memory management, workspace administration, integration diagnostics, MCP tooling, and deployment operations.
+Terminal-based access to the Great Arrow Digital platform — memory management, workspace administration, integration diagnostics, and MCP tooling.
 
 ## Install
 
@@ -10,6 +10,14 @@ npm install -g @great-arrow/cli
 
 Requires **Node.js 24+**.
 
+## Diagnostic telemetry
+
+CLI diagnostics are opt-in. Enable with `GAD_TELEMETRY=1` for a session or set
+`telemetry_enabled = true` in `~/.gadrc`; disable with `GAD_TELEMETRY=0`.
+Only bounded command, network, and MCP failure metadata is sent. Credentials,
+cookies, paths, and email-like fields are redacted; telemetry failures never
+affect command behavior.
+
 ## Authentication
 
 ```bash
@@ -101,6 +109,14 @@ override: `ALLOW_FOREIGN_WORKTREE=1`.
 # Full health check (token, API, integrations, MCP)
 gad doctor
 
+# Claude Code surface: server entry, hook wiring, hook credential — and
+# whether every hook you have CONFIGURED can actually run. That last check
+# reads all four settings scopes (managed, user, project, local), because a
+# hook that cannot execute fails silently on every single session and no
+# repo-side test can see your user or local file.
+gad doctor claude
+gad doctor claude --enforce   # back up and repair what is repairable
+
 # Integration management
 gad integrations list
 gad integrations sync github
@@ -109,10 +125,25 @@ gad integrations sync github
 ### MCP Server
 
 ```bash
+# Run a local stdio MCP server bridging to the hosted Great Arrow endpoint.
+# This is what AI clients configured with `npx -y @great-arrow/cli mcp start`
+# execute. Auth: GAD_API_TOKEN env → GAD_TOKEN env → stored `gad login`
+# credential. For one-off credentials, see `gad mcp start --help`.
+gad mcp start
+
 gad mcp status
 gad mcp logs
 gad mcp test
 
+# Audit every Great Arrow MCP connection on this machine: duplicate entries per
+# client (with the most capable one to keep and the exact command to drop the
+# rest), credential stores, and live reachability. `--migrate` copies the newest
+# valid legacy per-cwd credential into the per-user store and writes the
+# keychain credential to the file the stdio proxy reads first.
+gad mcp doctor
+gad mcp doctor --migrate
+gad mcp doctor --json
+
 # Generate MCP config for your AI client
 gad mcp install claude
 gad mcp install cursor
@@ -152,12 +183,9 @@ gad agent invoke research-analyst --task "Summarize Q2 metrics"
 gad ask "What did we decide about the caching layer?"
 ```
 
-### Deployment & Operations
+### Operations
 
 ```bash
-gad deploy              # Interactive confirmation
-gad deploy --confirm    # CI/CD (no prompt)
-gad migrate             # Run pending DB migrations
 gad smoke               # MCP smoke test suite
 ```