npm - @tiens.nguyen/gu-cli - Versions diffs - 1.0.881 → 1.0.883 - Mend

@tiens.nguyen/gu-cli 1.0.881 → 1.0.883

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 (5) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Tien Nguyen Song
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,157 +1,222 @@
-# @tiens.nguyen/gu-cli
-**gu** is a terminal coding agent for the folder you are in, plus the local worker that runs
-agent / OCR / PDF / embedding jobs on your machine (Ollama, MLX or any OpenAI-compatible server).
+<h1 align="center">gu — the coding agent in your terminal</h1>
+<p align="center">
+  <strong>It reads your repo, makes the change, and proves it works.</strong><br>
+  Your models — Ollama, MLX or any OpenAI-compatible provider. Your files stay in your folder.<br>
+  <strong>Free for 30 days. No account, no sign-in, no card.</strong>
+</p>
+<p align="center">
+  <a href="https://www.npmjs.com/package/@tiens.nguyen/gu-cli"><img alt="npm" src="https://img.shields.io/npm/v/@tiens.nguyen/gu-cli?color=6366f1&label=npm"></a>
+  <a href="https://www.npmjs.com/package/@tiens.nguyen/gu-cli"><img alt="downloads" src="https://img.shields.io/npm/dm/@tiens.nguyen/gu-cli?color=6366f1"></a>
+  <img alt="node" src="https://img.shields.io/node/v/@tiens.nguyen/gu-cli?color=6366f1">
+  <img alt="platforms" src="https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-supported-6366f1">
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/@tiens.nguyen/gu-cli?color=6366f1"></a>
+</p>
+<p align="center">
+  <a href="https://gucli.com">Website</a> ·
+  <a href="https://gucli.com/docs">Docs</a> ·
+  <a href="https://gucli.com/pricing">Pricing</a> ·
+  <a href="https://gucli.com/support">Support</a>
+</p>
+<p align="center">
+  <a href="https://gucli.com/videos/gu-design-web.mp4">
+    <img alt="gu building a web page from one request (click to watch)" src="https://gucli.com/videos/gu-design-web.jpg" width="760">
+  </a>
+  <br><sub>One request: gu plans, writes the files and checks the result. Click to watch.</sub>
+</p>
+## Install
 ```sh
 npm install -g @tiens.nguyen/gu-cli
-gu            # open the REPL in the current folder
+cd your-project
+gu
 ```
-The package installs three commands: `gu` (the terminal REPL), `gu-cli` and `gu-local-worker`
-(the same worker CLI). Requires Node.js 18 or newer. The install tries to put npm's global bin
-folder on your PATH, but npm 11 skips install scripts it was not told to allow (it prints
-"install scripts not yet covered by allowScripts"). If `gu` is "command not found" afterwards, run
-`npx @tiens.nguyen/gu-cli fix-path` (works even when `gu-cli` itself is not found). `gu-cli fix-path`
-also finds what an old install left behind - broken `gu` links, a second gu from another npm, a
-shell-profile PATH line pinned to a versioned Homebrew folder - and asks before fixing each
-(`--check` only reports). `gu support` sends the support team a request with gu's logs attached.
-On Windows, PowerShell's built-in `gu` alias (Get-Unique) shadows this CLI — run
-`gu-cli fix-powershell` to drop it.
+**Free to start, no account needed.** The first run creates a free 30-day token for this
+computer automatically. Press Enter to use it. It also asks how this machine runs and which model
+provider to use. Then type what you want done.
+> **`gu: command not found`?** Run `npx @tiens.nguyen/gu-cli fix-path`. See [Troubleshooting](#troubleshooting).
+## What it does
+- **Writes the code, in your terminal.** Ask in plain words; gu reads the repo, edits the files,
+  runs the build and the tests, and tells you what it changed.
+- **Your models.** Run [Ollama](https://ollama.com) or MLX on your own machine, or bring any
+  OpenAI-compatible provider. Switch at any time with `/model`.
+- **It stays in the repo.** Every edit is a file you can read, diff and revert, and `/undo` puts
+  back what a stopped turn changed. No hidden workspace.
+- **Knows your codebase.** Local RAG indexes the folder so the model finds the right files.
+- **Extensible.** [MCP](https://modelcontextprotocol.io) servers, skills (`SKILL.md`), and hooks.
+  Already set up for Claude Code? `/switch-skill claude` reuses its `.claude` folder.
+- **Tests in a real browser.** The `browser` tool drives Chrome to check the web pages it builds.
+- **Private by default.** Logs hold no prompts, code or keys unless you run `gu --log`.
 ## Quick start
-1. `gu login` — browser sign-in; writes `~/.gonext/worker.env`.
-   (Client Expert machines can instead paste a token from the Account page with `gu-cli token <token>`.)
-2. `gu doctor` — set up and check the models on this machine
-   (`gu doctor --client` installs only the agent dependencies when the models live on another machine).
-3. `gu` in a project folder, then type a request. Conversation history is saved per folder in
-   `~/.gonext/sessions` and resumed next time; `/new` starts a fresh one and archives the old one.
+1. **Start gu.** Run `gu` in a project folder. Your free 30-day token is created on the spot:
+   no sign-up, no browser, no card.
+2. **Check your models.** `gu doctor` sets up and tests the models on this machine.
+   (`gu doctor --client` installs only the agent's dependencies, when the models run elsewhere.)
+3. **Ask.** Type what you want done. Conversations are saved per folder and resumed next time;
+   `/new` starts a fresh one.
-A first install asks how this machine runs (hosted client / MLX host / private). Pass
-`--license <pro token>` to choose a pro license up front; without it a first install is private,
-meaning the whole stack runs on this machine.
+## Models
-## The `gu` REPL
+gu uses up to three models, each with its own command:
-```
-gu [-v|--verbose] [--log] [--name <text>] [--license <pro token>]
-```
+| Command | Model | Saved |
+| --- | --- | --- |
+| `/model` | **coding**: writes the code | this session (`/quick-models` keeps 2 to flip with ← / →) |
+| `/agent-model` | **agent**: talks to you and plans | this machine |
+| `/embed-model` | **embedding**: RAG (`nomic-embed-text`, `qwen3-embedding`), local or remote | this machine; re-indexes what was indexed |
-- `-v, --verbose` shows RAG index-file activity in the bottom bar.
-- `--name <text>` draws `<text>` instead of the gu logo in the startup banner (this run only). Letters, digits, space, `-` and `_` become block art; anything else, or a name over 12 characters, is shown as plain text.
-- `--log` logs this run in detail to `~/.gonext/worker.log`. Without it only starts, stops and errors are logged.
-- Ctrl-C stops following a turn.
+Run `/doctor` any time to check that each one answers.
-### Three models, three commands
+## Using gu
-| Command | Model it switches |
+```
+gu [-v|--verbose] [--log] [--color] [--name <text>] [--license <pro token>]
+```
+| Flag | Effect |
 | --- | --- |
-| `/model` | the CODING model (the one that writes code), for this session |
-| `/agent-model` | the AGENT model (the one that talks) — saved on this machine |
-| `/embed-model` | the RAG EMBEDDING model (nomic-embed-text / qwen3-embedding) and its server; re-indexes what is already indexed; supports a remote URL + API key |
+| `-v`, `--verbose` | show RAG index activity in the bottom bar |
+| `--log` | log this run in detail to `~/.gonext/worker.log` (default: starts, stops and errors only) |
+| `--color` | colour the live thought and the thinking spinner |
+| `--name <text>` | show `<text>` instead of the gu logo in the banner (this run only) |
+| `--license <token>` | choose a Pro licence on first install |
-`/agent-model` saves the model's server URL (`agentModelUrl`) together with its name, so picking a
-model from another provider (for example OpenAI) can no longer leave chat pointed at the old
-server. After picking, `gu doctor` shows the URL and model that are actually in use.
+Ctrl-C stops the running turn. Type `/` at the prompt to see every command; Tab completes.
-### Slash commands
+<details>
+<summary><strong>All slash commands</strong></summary>
 | Command | What it does |
 | --- | --- |
-| `/model`, `/agent-model`, `/embed-model` | switch models (see above) |
-| `/context-window [tokens\|auto]` | tell gu how big the coding model's context is (hosted models cannot be probed) |
-| `/doctor` | check every configured model answers, especially the embedder |
-| `/browser [allow\|forget\|install\|cleanup]` | the agent's web browser (UI tests): it asks before first use, then works in your Chrome through the gu extension or, with nothing installed, in gu's own Chrome window; `allow`/`forget` stop or restart the question for this folder; guide: [browser-extension/README.md](browser-extension/README.md) |
-| `/tokens` | break down the last prompt sent to the coding model — how much of it was RAG |
-| `/prices [update]` | price and cache tables, and what the last turn and this session cost |
-| `/rag` | where this folder's RAG knowledge base lives: local, cloud, or both |
-| `/s3 [test]` | set up your own S3 bucket (RAG index, generated PDFs/downloads) and check the AWS keys |
-| `/proxy [show\|set\|on\|off\|clear\|test]` | route model calls through an HTTP proxy (local calls always go direct) |
-| `/test-auto` | toggle auto-test (verify and fix until it passes) for this folder |
+| `/model`, `/quick-models`, `/agent-model`, `/embed-model` | switch models (see [Models](#models)) |
+| `/context-window [tokens\|auto]` | tell gu how big the coding model's context is (hosted models can't be probed) |
+| `/doctor` | check that every configured model answers, especially the embedder |
+| `/new` | start a new conversation in this folder (the old one is archived) |
 | `/undo [runId]` | put back the files the last stopped turn changed, from its backups (asks first) |
+| `/test-auto` | toggle auto-test for this folder: verify and fix until it passes |
+| `/browser [allow\|forget\|install\|cleanup]` | the agent's web browser, through the gu Chrome extension or gu's own Chrome window ([guide](browser-extension/README.md)) |
+| `/shells` | long commands the agent left running in the background: status, output, stop one |
+| `/rag` | where this folder's RAG index lives: local, cloud or both |
+| `/tokens` | break down the last prompt sent to the coding model, including how much was RAG |
+| `/prices [update]` | price tables, and what the last turn and this session cost |
+| `/budget` | your API provider budgets and balances (Pro) |
+| `/mcp [list\|tools\|add\|remove\|enable\|disable\|approve\|allow\|disallow\|reconnect]` | MCP servers, and which of their tools run without asking |
+| `/hooks [list\|approve\|unapprove]` | commands gu runs on `onStart`, `onAsk`, `onToolDone`, `onTurnEnd` |
+| `/switch-skill [claude\|gu]` | use Claude Code's (`.claude`) or gu's (`.gonext`) skills, MCP servers and hooks in this folder |
+| `/skills-copy-to-claude [--dry-run] [name…]` | copy gu's skills into Claude Code's folders |
+| `/proxy [show\|set\|on\|off\|clear\|test]` | route model calls through an HTTP proxy (local calls go direct) |
+| `/s3 [test]` | use your own S3 bucket for the RAG index and generated files |
 | `/server` | pick a deployment server (host/user) for this session |
-| `/host-mode` | undo client mode — run agent turns on this machine again |
-| `/save-settings [name\|path]`, `/load-settings [name\|path]` | move providers, models and key names (no secrets) to another machine |
-| `/save-preset [name]`, `/open-presets [name]`, `/use-presets [name]` | presets: your whole setup, keys included, to copy to another computer, edit, and apply (backs up first) |
-| `/hooks [list\|approve\|unapprove]` | commands gu runs on onStart, onAsk, onToolDone, onTurnEnd |
-| `/mcp [list\|tools\|add\|remove\|enable\|disable\|approve\|allow\|disallow\|reconnect]` | manage MCP servers and which of their tools run without asking |
-| `/switch-skill [claude\|gu]` | use Claude Code's (`.claude`) or gu's own (`.gonext`) skills, MCP servers and hooks for this folder |
+| `/host-mode` | undo client mode: run agent turns on this machine again |
+| `/save-settings`, `/load-settings` | move providers, models and key *names* (no secrets) to another machine |
+| `/save-preset`, `/open-presets`, `/use-presets` | your whole setup, keys included, to copy, edit and apply (backs up first) |
 | `/clear-logs` | show what logs, RAG indexes and old API versions take on disk, then ask what to clear |
-| `/new` | start a new conversation in this folder (the old one is archived) |
-| `/help`, `/exit` (`/quit`) | list commands / quit |
+| `/voucher CODE` | use a voucher code: adds free days to this computer's trial or your free account |
+| `/support` | send the support team a request with gu's logs attached (secrets masked; shows what goes first) |
+| `/help`, `/exit` | list commands / quit |
-Each skill in `~/.gonext/skills/<name>/SKILL.md` (and the folder's `.gonext/skills`) is also a
-slash command of its own. Run `/help` in the REPL for the list your version offers.
+Each skill in `~/.gonext/skills/<name>/SKILL.md` (or the folder's `.gonext/skills`) is a slash command too.
-## Shell commands
+</details>
+<details>
+<summary><strong>Shell commands</strong></summary>
 ```
-gu status                      worker + a table of the running model servers
-gu start | stop | restart      run the polling daemon in the background (stop --models: model servers too)
-gu logs [--lines N] [-f]       tail the daemon log; gu logs <port|pid|chat|embed> [-f] tails a model server's log
-gu doctor [--client]           set up models here
-gu rag                         test the embedder end-to-end and list knowledge bases
-gu rag plan [path]             is RAG worth it here? files / chars / chunks -> estimated index time
-gu rag --test                  can this machine embed and retrieve?
-gu api <start|stop|restart|status|upgrade>   the local API (Local / Client Expert only)
+gu status                      worker status and the running model servers
+gu start | stop | restart      the background worker (stop --models: model servers too)
+gu logs [--lines N] [-f]       tail the worker log; gu logs <port|pid|chat|embed> for a model server
+gu doctor [--client]           set up and check models on this machine
+gu rag [plan [path] | --test]  test the embedder, list knowledge bases, estimate index time
+gu api <start|stop|restart|status|upgrade>   the local API (private machines)
 gu workspace revert [runId]    undo an agent run's file edits from its backups
-gu test-proxy                  can this machine route model calls through a proxy?
-gu mongo migrate-from-docker   macOS: move a Docker MongoDB to native (Homebrew)
+gu support                     send a support request with masked logs
+gu test-proxy                  check model calls through a proxy
+gu mongo migrate-from-docker   macOS: move a Docker MongoDB to Homebrew
 gu clear [--scratch|--keep-history] [--yes]   back to a fresh machine (asks first)
-gu fix-path | fix-powershell   repair PATH / drop PowerShell's `gu` alias
+gu fix-path | fix-powershell   repair PATH / remove PowerShell's `gu` alias
 ```
-`gu-cli` accepts the same commands, plus `login [--api-base <url>]`, `set <workerKey> [--api-base <url>]`,
-`token [<token>]`, `ws-ping-test` and `simulate-chat [text...]`.
-`gu api restart` runs the installed version; an upgrade changes the files, not a process that is already serving.
+`gu-cli` takes the same commands, plus `login [--api-base <url>]`, `set <workerKey>`,
+`token [<token>]`, `ws-ping-test` and `simulate-chat [text…]`.
+</details>
-## Files and settings
+## Where gu keeps things
 | Path | Contents |
 | --- | --- |
-| `~/.gonext/worker.env` | sign-in: worker key and API base |
-| `~/.gonext/sessions/` | per-folder conversation history (`archive/` holds old conversations) |
-| `~/.gonext/worker.log` | worker log (detailed with `--log`) |
-| `~/.gonext/local-api.log` | the local API's log |
+| `~/.gonext/worker.env` | sign-in: worker key and API address |
+| `~/.gonext/sessions/` | conversation history per folder (`archive/` holds old ones) |
+| `~/.gonext/worker.log`, `~/.gonext/local-api.log` | logs |
 | `~/.gonext/mcp.json` | MCP servers and their allow rules |
-| `~/.gonext/skills/`, `.gonext/skills` | skills (global / this folder) |
+| `~/.gonext/skills/`, `<folder>/.gonext/skills/` | skills: everywhere / this folder only |
+## Plans
+| | How long | What you need |
+| --- | --- | --- |
+| **Free trial** | 30 days, starts on the first run | nothing: the token is created for you |
+| **Free plan** | 3 more months on that computer | a free account at [gucli.com](https://gucli.com) |
+| **Pro** | while subscribed | more computers, plus provider budgets |
+Got a **voucher code**? Type `/voucher CODE` in gu (or enter it on your
+[account page](https://gucli.com/account)) for extra free days on top.
-## Worker modes
+Free time belongs to the computer: reinstalling doesn't restart it. Already have a token? Paste
+it at the first-run question instead, or later with `gu-cli token <token>`. Current prices: [gucli.com/pricing](https://gucli.com/pricing).
-The background worker polls the API for jobs queued from the web app and runs them on this machine.
+## Troubleshooting
-### Agent chat
+**`gu: command not found` after install.** npm 11 skips install scripts it wasn't told to allow,
+so the step that adds npm's bin folder to your PATH may not have run. Run
+`npx @tiens.nguyen/gu-cli fix-path`. It also finds what an old install left behind (broken links,
+a second gu from another npm, a PATH line pinned to an old Homebrew folder) and asks before
+fixing each one. `--check` only reports.
-Choosing **Agent** under the composer in the web app hands your prompt to a
-[smolagents](https://github.com/huggingface/smolagents) agent running on your local model. It
-needs `pip install smolagents certifi` in the worker's Python environment (`certifi` gives
-HTTPS a trusted CA bundle on macOS). Agent mode is blocked for cloud models; pick a local
-MLX or Ollama model first. The script is `gonext_agent_chat.py`.
+**Windows: `gu` runs `Get-Unique`.** PowerShell has a built-in `gu` alias. Run `gu-cli fix-powershell`.
-### API check / HTTP probe
+**Node version.** Node.js 18+ runs the CLI. A private machine (API and database on this
+computer) needs **Node.js 20.19+**.
-- **Tools (`tool_only`)**: the worker runs the HTTP request itself, measures status, latency, headers and
-  body, classifies it (2xx/3xx/4xx/5xx/timeout/network_error), and the local model writes a one-line summary.
-- **Agents (`agentic`)**: a smolagents agent writes the summary; the measurement stays the source of truth.
+**A change in a model or setting seems ignored.** `gu doctor` shows the model and URL actually in use.
-### Environment variables
+**Still stuck?** Run `gu support` (or `/support` in gu, or click **? support** in the footer). It
+sends the team your request with gu's logs attached, secrets masked, and shows you what goes
+before sending.
+<details>
+<summary><strong>Advanced: worker jobs and environment variables</strong></summary>
+The background worker also runs jobs queued from the [web app](https://gucli.com) on this machine:
+- **Agent chat**: choosing **Agent** in the web app runs a
+  [smolagents](https://github.com/huggingface/smolagents) agent on your local model
+  (`pip install smolagents certifi`). Cloud models are not allowed here; pick a local MLX or Ollama model.
+- **API checks**: the worker makes the HTTP request itself, measures status, latency and body,
+  and a local model writes a one-line summary.
 | Variable | Meaning |
 | --- | --- |
-| `GONEXT_API_BASE`, `GONEXT_WORKER_KEY` | API URL and worker key (normally from `~/.gonext/worker.env`) |
-| `GONEXT_PROBE_PYTHON` | Python for smolagents scripts (default: `GONEXT_MLX_LM_PYTHON` or `python3`) |
-| `GONEXT_MLX_LM_PYTHON` | Python for the MLX LM native probe (default `python3`) |
-| `GONEXT_OCR_MODEL_PATH` | local GLM-OCR-bf16 directory (default `~/mlx-models/GLM-OCR-bf16`) |
-| `GONEXT_OCR_DEBUG=1` | print raw OCR stdout/stderr snippets |
-| `GONEXT_SIMULATE_TEXT` | default reply body for `simulate-chat` |
+| `GONEXT_API_BASE`, `GONEXT_WORKER_KEY` | API address and worker key (normally from `~/.gonext/worker.env`) |
+| `GONEXT_PROBE_PYTHON` | Python for agent scripts (default: `GONEXT_MLX_LM_PYTHON` or `python3`) |
+| `GONEXT_MLX_LM_PYTHON` | Python for the MLX probe (default `python3`) |
+| `GONEXT_OCR_MODEL_PATH` | local GLM-OCR directory (default `~/mlx-models/GLM-OCR-bf16`) |
+| `GONEXT_OCR_DEBUG=1` | print raw OCR output |
+| `GONEXT_SIMULATE_TEXT` | default reply for `simulate-chat` |
-## Development
+</details>
-```sh
-npm test            # python unittest + node --test
-npm run preflight   # checks before a release
-npm run publish:org # npm publish --access public
-```
+## License
-Source and issues: https://github.com/tiennsloit/gu
+[MIT](./LICENSE) © Tien Nguyen Song

package/cli-token.mjs CHANGED Viewed

@@ -533,6 +533,35 @@ export async function renewToken({ mode, apiBase, hostedBase, token, workerKey,
   }
 }
+/**
+ * /voucher CODE (#425): redeem a marketing code with this computer's token as the credential — a
+ * trial (no account) or an account. Returns { ok: true, days, token } — the token already carries the
+ * extra days — or { ok: false, why, error } where error is the service's own sentence. Never throws.
+ */
+export async function redeemVoucher({ mode, apiBase, hostedBase, token, device, code, fetchImpl = fetch, timeoutMs = 8000 }) {
+  const base = String(mode === "expert" ? hostedBase : apiBase || hostedBase).replace(/\/+$/, "");
+  if (!token) return { ok: false, why: "no-token", error: "This computer has no gu token yet — restart gu to get the free trial, then try again." };
+  if (!base) return { ok: false, why: "no-api", error: "No gu service address is set on this computer." };
+  try {
+    const res = await fetchImpl(`${base}/api/billing/cli-token/voucher`, {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
+      body: JSON.stringify({ code: String(code ?? ""), ...(device ? { device } : {}) }),
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    const data = await res.json().catch(() => null);
+    if (!res.ok) {
+      const error = typeof data?.error === "string" && data.error
+        ? data.error
+        : res.status === 404 ? "This gu service does not take vouchers yet." : `The gu service answered HTTP ${res.status}.`;
+      return { ok: false, why: typeof data?.why === "string" ? data.why : `http-${res.status}`, error };
+    }
+    return { ok: true, days: Number(data?.days ?? 0), token: typeof data?.token === "string" ? data.token : "" };
+  } catch (e) {
+    return { ok: false, why: "network", error: e?.name === "TimeoutError" ? "The gu service did not answer in time. Try again." : "Can't reach the gu service right now." };
+  }
+}
 // ---------------------------------------------------------------------------
 // WHAT THE BAR SAYS
 // ---------------------------------------------------------------------------

package/gu-repl.mjs CHANGED Viewed

@@ -1041,6 +1041,7 @@ const COMMANDS = [
   { name: "/shells", desc: "long commands the agent left running in the background — status, runtime, command, output; stop one" },
   { name: "/budget", desc: "short view of your API provider budgets and balances (Pro) — the same items as the web /providers page" },
   { name: "/tokens", desc: "break down the last prompt sent to the coding model — how much of it was RAG" },
+  { name: "/voucher", usage: "/voucher CODE", desc: "use a voucher code — it adds free days to this computer's trial or your free account" },
   { name: "/support", desc: "send the gu support team a request with gu's logs attached (secrets masked) — shows what goes first, then asks" },
   { name: "/clear-logs", desc: "show what gu's logs, RAG indexes and old API versions take on disk, then ask what to clear — the logs first" },
   { name: "/prices", usage: "/prices [update]", desc: "the price table and the cache table, and what the last turn and this session cost — \"update\" applies gu's newest published tables" },
@@ -8397,6 +8398,54 @@ async function noteTurnCost(inputTokens, breakdown, coder = null) {
  * use marked; what the last turn and this session cost; and, when gu has published newer tables,
  * that they are waiting. `/prices update` applies them — the same as clicking the notice.
  */
+/**
+ * /voucher CODE (#425) — a marketing code that adds free days. Works on the free trial (no account)
+ * and on a free account; the service answers with a fresh token that already carries the days, so
+ * the bar and the licence see them at once — no restart.
+ */
+async function runVoucherCommand(line = "/voucher") {
+  const code = line.trim().slice("/voucher".length).trim();
+  console.log("");
+  if (!code) {
+    console.log(GUTTER + "Type the code after the command: " + accent("/voucher CODE") + "\n");
+    return;
+  }
+  const ct = await import("./cli-token.mjs");
+  const pk = ct.publicKey();
+  const dir = join(homedir(), ".gonext");
+  const state = await ct.readState(dir);
+  const { DEFAULT_API_BASE } = await import("./device-login.mjs");
+  const device = await ct.thisDevice({ instanceId: myInstanceId || "" }).catch(() => null);
+  const r = await withPendingStatus("checking the voucher", () =>
+    ct.redeemVoucher({
+      mode: isClientExpert() ? "expert" : "client",
+      apiBase,
+      hostedBase: String(process.env.GU_TOKEN_API_BASE ?? "").trim() || DEFAULT_API_BASE,
+      token: state.token,
+      device,
+      code,
+    })
+  );
+  if (!r.ok) {
+    console.log(GUTTER + yellow(r.error) + "\n");
+    return;
+  }
+  // Kept only if it checks out here, like every renewal.
+  const check = r.token && pk ? ct.verifyCliToken(r.token, pk) : { ok: false };
+  if (check.ok) {
+    await ct.writeState(dir, { token: r.token, lastAttemptAt: new Date().toISOString() }).catch(() => {});
+    const d = ct.enforcementDecision({ token: r.token, publicKeyB64: pk, site: ct.siteUrl(), deviceId: await thisDeviceId(ct) });
+    licenceBlock = d.enforced && !d.allowed ? d.why : null;
+    tokenNotice = ct.barNotice({ token: r.token, publicKeyB64: pk, mode: isClientExpert() ? "expert" : "client", now: new Date(), attempted: true, site: ct.siteUrl() });
+  }
+  const p = check.ok ? check.payload : null;
+  const until = p?.plan === "trial" ? p.paidUntil : p?.plan === "free" && typeof p.freeUntil === "string" ? p.freeUntil : null;
+  console.log(GUTTER + accent(`✓ +${r.days} free days added.`) + (until ? ` Free on this computer until ${ct.shortDate(until)}.` : ""));
+  if (!check.ok) console.log(GUTTER + dim("gu picks the days up at its next token refresh (within the hour)."));
+  console.log("");
+  if (barPinned()) paintBar();
+}
 async function runPricesCommand(line = "/prices") {
   const mp = await import("./model-prices.mjs");
   console.log("");
@@ -15080,6 +15129,10 @@ async function main() {
       await runPricesCommand(line);
       continue;
     }
+    if (line === "/voucher" || line.startsWith("/voucher ")) {
+      await runVoucherCommand(line);
+      continue;
+    }
     if (line === "/clear-logs") {
       await runClearLogs();
       continue;

package/package.json CHANGED Viewed

@@ -1,17 +1,28 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.881",
-  "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
-  "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tiennsloit/gu.git"
-  },
-  "homepage": "https://github.com/tiennsloit/gu#readme",
+  "version": "1.0.883",
+  "description": "gu: the coding agent in your terminal. It reads your repo, makes the change and runs the tests, with your own models (Ollama, MLX or any OpenAI-compatible provider). macOS, Linux and Windows.",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "cli",
+    "terminal",
+    "llm",
+    "ollama",
+    "mlx",
+    "openai",
+    "agent",
+    "mcp",
+    "rag",
+    "code-assistant"
+  ],
+  "homepage": "https://gucli.com",
   "bugs": {
-    "url": "https://github.com/tiennsloit/gu/issues"
+    "url": "https://gucli.com/support"
   },
+  "license": "MIT",
+  "author": "Tien Nguyen Song",
+  "type": "module",
   "bin": {
     "gu-cli": "gu-cli.mjs",
     "gu-local-worker": "gu-cli.mjs",