nexrall-code 0.5.190 → 0.5.192
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 +20 -9
- package/dist/index.js +3300 -1250
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# Nexrall Code CLI
|
|
2
2
|
|
|
3
|
-
**Nexrall Code in your terminal**
|
|
3
|
+
**Nexrall Code in your terminal** — an autonomous coding agent for scripts, CI, and terminal-first workflows. The same agent engine as the Nexrall Code VS Code extension, powered by [Nexrall](https://nexrall.com).
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
npm install -g nexrall-code
|
|
7
7
|
nex
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
Requires Node.js 20+ and a Nexrall account
|
|
10
|
+
Requires Node.js 20+ and a Nexrall account — it signs in with the same account as the extension; billing stays in one place and there are no API keys to configure.
|
|
11
11
|
|
|
12
12
|
## Quick start
|
|
13
13
|
|
|
@@ -27,6 +27,7 @@ Inside an interactive session:
|
|
|
27
27
|
- Shift+Tab (or `/mode`) switches ask / edit / auto / plan
|
|
28
28
|
- Esc stops the current turn; Ctrl+Up/Down (or `/find`) browses the conversation
|
|
29
29
|
- long tool output folds to an 8-line preview; Ctrl+O (or `/expand`) shows the rest
|
|
30
|
+
- `/stats` reports usage across sessions — activity by day, tokens and models, read from your local logs
|
|
30
31
|
|
|
31
32
|
## Scripting and CI
|
|
32
33
|
|
|
@@ -34,11 +35,19 @@ Inside an interactive session:
|
|
|
34
35
|
nex --output-format json "summarise the failing tests" > result.json
|
|
35
36
|
```
|
|
36
37
|
|
|
37
|
-
- `--output-format text|json|stream-json`
|
|
38
|
-
- `--no-banner`, `--no-color` (or `NO_COLOR`)
|
|
39
|
-
- `--plan` / `--readonly`
|
|
40
|
-
- `--audit [path]`
|
|
41
|
-
- `-w, --worktree [name]`
|
|
38
|
+
- `--output-format text|json|stream-json` — machine-readable one-shot output (implies auto-approve)
|
|
39
|
+
- `--no-banner`, `--no-color` (or `NO_COLOR`) — clean output for pipes
|
|
40
|
+
- `--plan` / `--readonly` — start in plan mode; read-only is a lock that cannot be switched off
|
|
41
|
+
- `--audit [path]` — append every tool call (and refusal) to a local JSONL trail
|
|
42
|
+
- `-w, --worktree [name]` — run the session in its own git worktree
|
|
43
|
+
|
|
44
|
+
Costs and tokens are collected locally too:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
nex usage export --since 7d --format csv --out usage.csv
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
`nex usage export` reads the same local event logs as `/stats` and prints cost/token/tool usage across sessions as JSON (default), JSONL, or CSV. `--since` / `--until` accept `7d`, `48h`, or a date like `2026-10-01`; `--out` writes to a file. To ship session events as OTLP telemetry instead, set `NEXRALL_ENABLE_TELEMETRY=1` (off by default).
|
|
42
51
|
|
|
43
52
|
## Commands
|
|
44
53
|
|
|
@@ -49,6 +58,8 @@ nex --output-format json "summarise the failing tests" > result.json
|
|
|
49
58
|
| `nex doctor` | Check Node, sign-in, network, terminal, MCP and storage, with a fix for each problem |
|
|
50
59
|
| `nex billing` | Show, or change, which budget pays for your usage |
|
|
51
60
|
| `nex sessions` | List or delete saved chat sessions |
|
|
61
|
+
| `nex tasks` | The shared task board: seed, claim, complete or release tasks from the shell — sessions share the same list |
|
|
62
|
+
| `nex usage` | Export local cost/token/tool usage: `nex usage export` (JSON, JSONL, CSV) |
|
|
52
63
|
| `nex plugin` | Manage plugins: install from GitHub, list, update, remove |
|
|
53
64
|
| `nex update` | Update `nex` to the latest version |
|
|
54
65
|
|
|
@@ -58,7 +69,7 @@ Official plugins live in [Maxrall-Inc/plugins](https://github.com/Maxrall-Inc/pl
|
|
|
58
69
|
|
|
59
70
|
| Flag | What it does |
|
|
60
71
|
|---|---|
|
|
61
|
-
| `-m, --model <name>` | Explicit model, e.g. `claude-opus-5-5` or `
|
|
72
|
+
| `-m, --model <name>` | Explicit model, e.g. `claude-opus-5-5` or `glm-5.3` |
|
|
62
73
|
| `-e, --effort <level>` | Thinking effort; the real levels depend on the model |
|
|
63
74
|
| `-d, --dir <path>` | Working directory |
|
|
64
75
|
| `--mode <mode>` | Starting permission mode: ask, edit, auto or plan |
|
|
@@ -69,7 +80,7 @@ Run `nex --help` for the full list.
|
|
|
69
80
|
|
|
70
81
|
## Issues
|
|
71
82
|
|
|
72
|
-
Bug reports and feature requests: **[github.com/Maxrall-Inc/nexrall-
|
|
83
|
+
Bug reports and feature requests: **[github.com/Maxrall-Inc/nexrall-issue](https://github.com/Maxrall-Inc/nexrall-issue/issues)**.
|
|
73
84
|
|
|
74
85
|
## License
|
|
75
86
|
|