@m8t-stack/cli 0.2.27 → 0.2.28
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 +8 -8
- package/dist/cli.js +136 -110
- package/dist/cli.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# `@m8t-stack/cli` — the `m8t` CLI
|
|
2
2
|
|
|
3
|
-
> 📖 Reference for the `m8t` command-line tool that manages m8t
|
|
3
|
+
> 📖 Reference for the `m8t` command-line tool that manages m8t deployments.
|
|
4
4
|
|
|
5
5
|
## What it is
|
|
6
6
|
|
|
7
|
-
The `m8t` CLI manages a deployed m8t
|
|
7
|
+
The `m8t` CLI manages a deployed m8t platform: identity (`whoami`, `status`, `doctor`), config (`config`, `switch`), team membership (`team`), channel bindings (`bind`), the gateway stack (`deploy`), hosted coders (`coder`), and brains (`brain`). It's published to npm, Homebrew, and Scoop.
|
|
8
8
|
|
|
9
9
|
## Why / how it fits
|
|
10
10
|
|
|
@@ -50,7 +50,7 @@ m8t doctor # Health checks (az · config · tenant align · gat
|
|
|
50
50
|
m8t doctor --agent <name> # + delivery-grant check: verifies the agent's MI holds Key Vault Secrets User
|
|
51
51
|
m8t open [webapp|foundry|portal] # Open the deployed app / Foundry portal / resource group in a browser
|
|
52
52
|
|
|
53
|
-
# Local config (~/.m8t
|
|
53
|
+
# Local config (~/.m8t)
|
|
54
54
|
m8t config show # config.yaml (tenant/client/project) + the cached gateway
|
|
55
55
|
m8t config set <key> <value> # set tenantId | clientId | projectEndpoint
|
|
56
56
|
m8t config reset # clear the gateway discovery cache
|
|
@@ -80,7 +80,7 @@ Available on all gateway-using commands (`whoami`, `config show`, `config reset`
|
|
|
80
80
|
`team add`, `team list`, `team show`, `team add-identity`, `team remove-identity`,
|
|
81
81
|
`team remove`, `bind add`, `bind list`, `bind show`, `bind remove`, `bind cleanup`).
|
|
82
82
|
Pins gateway discovery to the named subscription, bypassing the active `az`
|
|
83
|
-
subscription. Useful when you manage multiple m8t
|
|
83
|
+
subscription. Useful when you manage multiple m8t deployments across
|
|
84
84
|
subscriptions or when your shell's active subscription differs from the deployment
|
|
85
85
|
target.
|
|
86
86
|
|
|
@@ -90,7 +90,7 @@ m8t team list --subscription <subscription-id-or-name>
|
|
|
90
90
|
|
|
91
91
|
## Local context & config — `status` / `doctor` / `switch`
|
|
92
92
|
|
|
93
|
-
The CLI reads two local files under `~/.m8t
|
|
93
|
+
The CLI reads two local files under `~/.m8t/`: **`config.yaml`** (your `tenantId`, `clientId`, and Foundry `projectEndpoint` — used by the web app + architect) and **`cli-config.yaml`** (the auto-discovered gateway URL cache).
|
|
94
94
|
|
|
95
95
|
- **`m8t status`** — a read-only snapshot of everything local: your signed-in `az` identity + active subscription/tenant, `config.yaml` (tenant / client / project), the gateway cache, the `azd` auth mode, and whether your `az` tenant matches `config.yaml` (tenant alignment). `--output json` for scripting.
|
|
96
96
|
- **`m8t doctor`** — runs health checks and prints a fix for each failure; exits non-zero if any check FAILs. Checks: `az` signed in · `config.yaml` valid · tenant alignment · gateway reachable (`/api/me`) · **Foundry data-plane reachable** (a 401/403 prints the exact `az role assignment create … "Cognitive Services User"` command) · **model-quota check** (warns for any deployed model with 0 TPM quota in the region). Results stream as each check runs. Pass `--agent <name>` to add a targeted delivery-grant check: reads the agent's deployed env and verifies its managed identity holds `Key Vault Secrets User` on the configured vault.
|
|
@@ -201,7 +201,7 @@ Granular error info in stderr's structured JSON envelope.
|
|
|
201
201
|
|
|
202
202
|
Run `az login` first. The CLI uses your active `az` session to acquire a token for the gateway.
|
|
203
203
|
|
|
204
|
-
### `error: No m8t
|
|
204
|
+
### `error: No m8t deployment found in subscription <name>.`
|
|
205
205
|
|
|
206
206
|
The deployment is in a different subscription. Switch with:
|
|
207
207
|
|
|
@@ -211,9 +211,9 @@ m8t config reset
|
|
|
211
211
|
m8t team list
|
|
212
212
|
```
|
|
213
213
|
|
|
214
|
-
### `error: Multiple m8t
|
|
214
|
+
### `error: Multiple m8t deployments found ...`
|
|
215
215
|
|
|
216
|
-
You have more than one gateway in this subscription. The CLI prompts you to pick one when running interactively (e.g. `m8t whoami`). The choice is cached at `~/.m8t
|
|
216
|
+
You have more than one gateway in this subscription. The CLI prompts you to pick one when running interactively (e.g. `m8t whoami`). The choice is cached at `~/.m8t/cli-config.yaml`. Or pass `--subscription <id>` to target a specific subscription and skip the picker entirely.
|
|
217
217
|
|
|
218
218
|
### `(gateway is starting up...)`
|
|
219
219
|
|