bitspark-agw 0.7.0-edge.16

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 +38 -0
  2. package/dist/main.js +25426 -0
  3. package/package.json +33 -0
package/README.md ADDED
@@ -0,0 +1,38 @@
1
+ # `bitspark-agw` — Agent Gateway CLI
2
+
3
+ `agw` sets up and manages your project's connection to a Claude Gateway: wire a project through the
4
+ gateway, manage your projects and credentials, and read your usage — from one small binary.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ npm i -g bitspark-agw
10
+ agw --version
11
+ ```
12
+
13
+ Requires **Node 24+**.
14
+
15
+ ## Quick start
16
+
17
+ ```bash
18
+ # Point at your gateway (adminUrl = management API, compatUrl = the Anthropic-compatible proxy)
19
+ agw target add local --admin-url http://127.0.0.1:3301 --compat-url http://127.0.0.1:3300
20
+ agw target use local
21
+
22
+ agw init # mint a project credential → write .claude/settings.local.json
23
+ agw status # this project's wiring + today's spend
24
+ agw runs # run history agw tail # live run events
25
+ agw usage # today's spend + budget
26
+
27
+ agw --help # full command list agw completion bash # shell completion (also zsh|fish|pwsh)
28
+ ```
29
+
30
+ For agents/CI, `agw init` wires a credential into `.claude/settings.local.json` — no login needed.
31
+ Logging in with an account (`agw login`) resolves your role and adjusts the available surface
32
+ automatically; the gateway server is always the enforcement boundary.
33
+
34
+ ## Configuration
35
+
36
+ `agw` stores named environments and your session under `~/.agw/`. Endpoint resolution precedence:
37
+ `--base-url`/`--target` flags ▸ a per-project `.agw.json` ▸ `~/.agw/config.json` ▸ `AGW_*` env vars.
38
+ Run `agw target show` to see what resolves for the current directory.