@v5x/cli 0.0.23 → 0.0.24
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 +19 -2
- package/dist/index.js +1426 -1018
- package/dist/index.js.map +22 -19
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -6,6 +6,12 @@ See the [complete CLI documentation](https://docs.v5x.dev/cli/overview) for work
|
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
9
|
+
```sh
|
|
10
|
+
curl -fsSL https://v5x.dev/install.sh | sh
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Alternatively, install the package with Bun 1.3.14 or newer:
|
|
14
|
+
|
|
9
15
|
```sh
|
|
10
16
|
bun add --global @v5x/cli
|
|
11
17
|
```
|
|
@@ -14,8 +20,8 @@ The CLI supports PROS, vexide, and VEXcode C++ projects. The corresponding
|
|
|
14
20
|
compiler toolchain must be installed before building a project.
|
|
15
21
|
|
|
16
22
|
The current CLI release supports Linux and macOS, matching the package
|
|
17
|
-
metadata's `os` field.
|
|
18
|
-
|
|
23
|
+
metadata's `os` field. Windows is not published yet because the CLI needs a
|
|
24
|
+
compatible serial backend there.
|
|
19
25
|
For browser integrations, use
|
|
20
26
|
`@v5x/serial` in a browser that implements Web Serial.
|
|
21
27
|
|
|
@@ -73,6 +79,17 @@ v5x kv set key value
|
|
|
73
79
|
Hardware commands accept `--port <path-or-id>` to target a specific serial
|
|
74
80
|
device. Set `V5X_PORT` to use the same selector without repeating the flag.
|
|
75
81
|
|
|
82
|
+
## Errors and exit codes
|
|
83
|
+
|
|
84
|
+
Errors use a colored `error:` prefix. Pass `--verbose` or set `V5X_DEBUG=1` to
|
|
85
|
+
include a stack trace. The CLI uses these exit codes for automation:
|
|
86
|
+
|
|
87
|
+
- `1`: an unclassified failure
|
|
88
|
+
- `2`: invalid arguments or usage
|
|
89
|
+
- `3`: no matching or connected V5 device
|
|
90
|
+
- `4`: a device protocol, transfer, or firmware failure
|
|
91
|
+
- `5`: an I/O or download failure
|
|
92
|
+
|
|
76
93
|
## Development
|
|
77
94
|
|
|
78
95
|
```sh
|