nexrall-code 0.5.191 → 0.5.193

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 +20 -10
  2. package/dist/index.js +3504 -1473
  3. 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** - an autonomous coding agent for scripts, CI, and terminal-first workflows. The same agent engine as the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=NexrallCode.nexrall-code-vscode), powered by [Nexrall](https://nexrall.com).
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. It signs in with the same account as the extension; billing stays in one place and there are no API keys to configure.
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` - machine-readable one-shot output (implies auto-approve)
38
- - `--no-banner`, `--no-color` (or `NO_COLOR`) - clean output for pipes
39
- - `--plan` / `--readonly` - start in plan mode; read-only is a lock that cannot be switched off
40
- - `--audit [path]` - append every tool call (and refusal) to a local JSONL trail
41
- - `-w, --worktree [name]` - run the session in its own git worktree
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,7 +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 |
52
- | `nex tasks` | The shared task board: seed, claim, complete or release tasks from the shell - sessions share the same list |
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) |
53
63
  | `nex plugin` | Manage plugins: install from GitHub, list, update, remove |
54
64
  | `nex update` | Update `nex` to the latest version |
55
65
 
@@ -59,7 +69,7 @@ Official plugins live in [Maxrall-Inc/plugins](https://github.com/Maxrall-Inc/pl
59
69
 
60
70
  | Flag | What it does |
61
71
  |---|---|
62
- | `-m, --model <name>` | Explicit model, e.g. `claude-opus-5-5` or `gpt-5.4` |
72
+ | `-m, --model <name>` | Explicit model, e.g. `claude-opus-5-5` or `glm-5.3` |
63
73
  | `-e, --effort <level>` | Thinking effort; the real levels depend on the model |
64
74
  | `-d, --dir <path>` | Working directory |
65
75
  | `--mode <mode>` | Starting permission mode: ask, edit, auto or plan |
@@ -70,7 +80,7 @@ Run `nex --help` for the full list.
70
80
 
71
81
  ## Issues
72
82
 
73
- Bug reports and feature requests: **[github.com/Maxrall-Inc/nexrall-code-issues](https://github.com/Maxrall-Inc/nexrall-code-issues/issues)**.
83
+ Bug reports and feature requests: **[github.com/Maxrall-Inc/nexrall-issue](https://github.com/Maxrall-Inc/nexrall-issue/issues)**.
74
84
 
75
85
  ## License
76
86