@rehpic/vcli 0.1.0-beta.9.1 → 0.1.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.
package/README.md CHANGED
@@ -1,6 +1,12 @@
1
- # Vector CLI
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/xrehpicx/vector/main/public/icons/vector-wordmark-dark.png">
4
+ <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/xrehpicx/vector/main/public/icons/vector-wordmark.png">
5
+ <img alt="Vector" src="https://raw.githubusercontent.com/xrehpicx/vector/main/public/icons/vector-wordmark.png" width="220">
6
+ </picture>
7
+ </p>
2
8
 
3
- CLI for interacting with a Vector workspace from the terminal.
9
+ <p align="center">CLI for interacting with a Vector workspace from the terminal.</p>
4
10
 
5
11
  This package wraps the same auth and Convex-backed workflows used by the app, so you can manage orgs, roles, teams, projects, issues, documents, notifications, and admin settings without opening the UI.
6
12
 
@@ -36,9 +42,12 @@ The app URL is required. `vcli` resolves it from:
36
42
  - the saved profile session
37
43
  - `NEXT_PUBLIC_APP_URL`
38
44
 
39
- The Convex URL still defaults from:
45
+ The Convex URL resolves from:
40
46
 
41
- - `NEXT_PUBLIC_CONVEX_URL` or `CONVEX_URL`
47
+ - `--convex-url <url>`
48
+ - the saved profile session
49
+ - the app's `/api/config` endpoint
50
+ - `NEXT_PUBLIC_CONVEX_URL` or `CONVEX_URL` as local fallbacks when the app reports the default local URL
42
51
 
43
52
  You can override either with flags:
44
53
 
@@ -118,6 +127,7 @@ vcli issue assignments API-1
118
127
  vcli issue set-priority API-1 High
119
128
  vcli issue replace-assignees API-1 "alice,bob"
120
129
  vcli issue comment API-1 --body "Investigating now."
130
+ vcli issue link-github API-1 "https://github.com/acme/api/pull/123"
121
131
  ```
122
132
 
123
133
  Invites and notifications:
@@ -181,12 +191,21 @@ Auth errors against the wrong app
181
191
 
182
192
  Convex connection errors
183
193
 
184
- - Set `--convex-url`, `NEXT_PUBLIC_CONVEX_URL`, or `CONVEX_URL`.
194
+ - Make sure `--app-url` points at the right Vector app first, since `vcli` fetches the Convex URL from that app when possible.
195
+ - Otherwise set `--convex-url`, `NEXT_PUBLIC_CONVEX_URL`, or `CONVEX_URL`.
185
196
 
186
197
  Validation errors when creating teams or projects
187
198
 
188
199
  - Use short slug-like keys such as `eng`, `api`, or `mobile-platform`.
189
200
 
201
+ ## AI Agent Skill
202
+
203
+ Install the Vector CLI skill for your AI coding agent:
204
+
205
+ ```bash
206
+ npx skills add xrehpicx/vector-skill
207
+ ```
208
+
190
209
  ## Help
191
210
 
192
211
  Inspect command groups directly: