jaitus 0.3.19 → 0.3.21

package/LICENSE

@@ -1,6 +1,6 @@
 Jaitus CLI — Proprietary Software Licence
 
-Copyright (c) 2026 Jaitus. All rights reserved.
+Copyright (c) 2026 Lakshya Pratap Singh, trading as Jaitus. All rights reserved.
 
 This software and its source code (the "Software") are the property of Jaitus and
 are licensed, not sold.

package/README.md

@@ -30,7 +30,8 @@ Set `JAITUS_RENDERER=classic` if you need the legacy renderer temporarily.
 ## Start
 
 Create an account at [jaitus.com](https://www.jaitus.com) — every new account gets free
-prompts to try it — then:
+prompts to try it (a set number of prompts and tokens, whichever runs out first). No card
+needed, and linking GitHub adds more. Then:
 
 ```bash
 jaitus login              # opens your browser, nothing to copy
@@ -56,7 +57,7 @@ changing a file or running a command, showing you exactly what it is about to do
     - return JSON.parse(x)
     + try { return JSON.parse(x) } catch { return null }
 
-  [y] once   [a] always this session   [n] no ›
+  [y] once   [s] this session   [a] always (saved for this project)   [n] no (Enter)  ›
 ```
 
 ## Commands
@@ -67,7 +68,7 @@ changing a file or running a command, showing you exactly what it is about to do
 | `jaitus "<task>"` | run one task and exit |
 | `jaitus login` / `logout` | sign in through the browser / sign this computer out |
 | `jaitus whoami` | which account, which plan, this period's usage |
-| `jaitus usage` | plan allowance, requests and tokens used |
+| `jaitus usage` | your plan's 5-hour window, weekly and monthly usage (or free prompts left) |
 | `jaitus sessions` | list saved sessions |
 | `jaitus mcp list` | list configured MCP servers |
 | `jaitus config` | show or change CLI settings |
@@ -82,25 +83,57 @@ changing a file or running a command, showing you exactly what it is about to do
 | | |
 |---|---|
 | `/help` | these commands |
-| `/model [id]` | show or change the model for this session |
+| `/model [id]` | the model setting — Jaitus picks the model for each request |
+| `/status` | model, mode, account, directory, context usage |
 | `/cost` | tokens used so far this session |
-| `/status` | current model, mode, session, and context |
-| `/context` | inspect the current context |
-| `/compact [focus]` | summarize and free context |
+| `/context` | what the model sees this turn (messages, project notes) |
+| `/clear` | start the conversation over |
+| `/undo` | drop the last exchange |
+| `/compact [focus]` | summarise the conversation to free context |
+| `/export [file]` | write the conversation to a file (txt/md/json) |
+| `/copy` | copy the last response to the clipboard |
+| `/diff` | uncommitted changes, staged or not, and new files |
+| `/tasks` | review tool activity from this session |
+| `/image <path>` | attach an image (png/jpg/gif/webp) the model will see with your next message |
+| `/memory [text]` | show or append to `JAITUS.md` (`#` does this inline) |
+| `/permissions [mode\|rules\|default]` | permission mode, the mode new sessions start in, and the allow/deny rules for this project |
 | `/skills` | list project workflows |
-| `/sessions` | list saved sessions |
-| `/resume <id>` | load a saved session |
+| `/sessions` | list saved sessions in this directory |
+| `/resume <id>` | load another saved session |
 | `/rename <title>` | name this session |
-| `/hooks` | show lifecycle hooks |
-| `/tui [fullscreen\|default]` | switch renderer, relaunching with the conversation intact |
-| `/fork` | copy this conversation into a brand-new session |
-| `/theme [name]` | color theme: dark, light, ocean, daltonized, auto (the default: asks the terminal for its background colour) |
-| `/scroll-speed [n]` | mouse-wheel speed, 0.25–20 |
+| `/hooks` | show configured lifecycle hooks |
+| `/tui [fullscreen\|default]` | switch renderer, relaunching with this conversation intact |
+| `/theme [name]` | colour theme: dark, light, ocean, daltonized, auto (the default: asks the terminal for its background colour) |
+| `/vim` | toggle Vim modal editing for the prompt |
+| `/attach <id>` | watch a background job log live (Esc stops watching) |
+| `/stop <id>` | stop a running background job |
+| `/debug` | terminal and renderer diagnostics for bug reports |
 | `/agent <task>` | run an isolated read-only side task |
-| `/cwd` | which directory the agent is working in |
-| `/clear` | start the conversation over |
-| `/undo` | drop the last exchange |
-| `/exit` | leave |
+| `/btw <question>` | side question, answered without touching history |
+| `/research [--deep] <q>` | web research with sources (read-only) |
+| `/ask <question>` | read-only explanation mode; never edits files |
+| `/architect <task>` | read-only architecture mode; compare designs and risks |
+| `/code` | implementation mode; keeps the current approval policy |
+| `/explain <topic>` | explain a file, symbol, error or concept from this project |
+| `/test [args]` | run the project tests; `--fix` lets the agent repair failures |
+| `/review [--fix]` | review the diff for bugs; `--fix` applies the findings |
+| `/security-review [--fix]` | review the diff for vulnerabilities |
+| `/simplify [--fix]` | readability-only pass over the change |
+| `/commit` | review the diff, write a real message, commit (push is separate) |
+| `/plan [task]` | read-only plan mode, optionally for one task |
+| `/branch [name]` | branch the conversation, return with `/resume` |
+| `/rewind [turn]` | restore conversation and files to an earlier turn |
+| `/feedback [text]` | save a note about a problem, with session details, on this computer |
+| `/login` | sign in as a different account |
+| `/logout` | sign this device out and leave |
+| `/doctor` | diagnose setup problems |
+| `/whoami` | who you are signed in as |
+| `/usage` | your plan's 5-hour window, weekly and monthly usage (or free prompts left) |
+| `/init` | create `JAITUS.md` and `.jaitusignore` here |
+| `/mcp [list\|add\|remove]` | list or configure MCP tool servers |
+| `/config [key] [value]` | show or change CLI settings |
+| `/update` | check whether a newer version is published |
+| `/exit` | leave (the only way out — `Ctrl+C` never exits) |
 
 Arrow keys, Home/End, `Ctrl+A`/`Ctrl+E`, `Ctrl+W` (delete a word), `Ctrl+U`/`Ctrl+K`
 (delete to the start/end) all work, and the cursor is drawn where you are typing.
@@ -140,7 +173,7 @@ Drag selects and copies on release; double-click selects a word, triple-click a
 
 | | |
 |---|---|
-| `--model <id>` | override the model for this run |
+| `--model <id>` | model id for this run (leave it out: Jaitus picks the model for each request) |
 | `--print, -p` | headless one-prompt mode |
 | `--continue, -c` | continue the latest session in this directory |
 | `--resume, -r <id>` | resume a saved session |
@@ -195,13 +228,14 @@ Environment variables it reads: `NO_COLOR`, `FORCE_COLOR`, `JAITUS_ASCII` (plain
 `JAITUS_NO_BANNER`, `JAITUS_DEBUG` (stack traces).
 Renderer: fullscreen on capable terminals, classic scrollback on legacy consoles
 or pipes. Force either way with `JAITUS_FULLSCREEN=1` / `JAITUS_NO_FULLSCREEN=1`
-(`/tui` switches mid-session), `JAITUS_16COLOR=1` for sixteen colors,
+(`/tui` switches mid-session), `JAITUS_16COLOR=1` for sixteen colours,
 `JAITUS_NO_ANIMATION=1` for reduced motion.
 
 ## Extending it
 
 - `.jaitus/skills/<name>/SKILL.md` adds a workflow available as `/<name>`, in the open
-  Agent Skills format. Skills already in `.claude/skills` are picked up too.
+  Agent Skills format. Skills written for other coding agents in the same format are
+  picked up too.
 - `.jaitus/hooks.json` adds lifecycle commands. A non-zero `beforePrompt` hook blocks the
   request; hook output is not echoed into the transcript.
 - `.mcp.json` configures local stdio MCP servers. Use `jaitus mcp list`, `jaitus mcp add`
@@ -211,13 +245,14 @@ or pipes. Force either way with `JAITUS_FULLSCREEN=1` / `JAITUS_NO_FULLSCREEN=1`
 
 ## Safety
 
-- Every path is resolved and checked to be inside the working directory, symlinks
-  included. The agent cannot read or write outside the project you started it in.
+- The file tools only read and write inside the folder you started it in, symlinks
+  included. Shell commands run as you and can reach anything you can, which is why each
+  one asks first unless you allow it.
 - Writes and commands need permission. `--yes` skips the prompts and is deliberately not
   the default; without a terminal to ask in, an action that needs permission is refused
   rather than assumed.
 - Commands run with no TTY, so anything interactive exits instead of hanging forever.
-- The agent runs until the task is done. If it repeats the same action four times without changing anything it stops and says so, rather than looping on your bill.
+- The agent runs until the task is done. If it repeats the same action four times without changing anything it stops and says so, rather than burning through your plan's limits.
 - `jaitus doctor` never prints your sign-in token — only whether you are signed in.
 
 ## Signing in
@@ -227,14 +262,15 @@ or pipes. Force either way with `JAITUS_FULLSCREEN=1` / `JAITUS_NO_FULLSCREEN=1`
 browser, the browser carries back a single-use code, and the CLI exchanges that code over
 HTTPS for a short-lived sign-in token that renews itself. No token ever travels in a URL.
 
-Each computer you sign in on appears under **Devices** on the website, where you can sign
-it out. `jaitus logout` signs out this computer only.
+Each computer you sign in on is listed under **Signed-in devices** on your dashboard,
+where you can sign it out. `jaitus logout` signs out this computer only.
 
 ## Plans
 
-Jaitus is a subscription. Plans are listed at [jaitus.com](https://www.jaitus.com); each
-includes a monthly token allowance. `jaitus whoami` and `jaitus usage` show where you
-are in the current period.
+Plans are listed at [jaitus.com](https://www.jaitus.com). A plan lasts 30 days and does
+not renew automatically — buy another 30 days when you want to keep going. Each plan has
+a 5-hour window, a weekly limit and a monthly limit; `jaitus whoami` and `jaitus usage`
+show each as a percentage, with when it resets.
 
 ## Requirements
 
@@ -242,5 +278,5 @@ Node 20 or newer.
 
 ## Licence
 
-Proprietary. © 2026 Jaitus. All rights reserved. Use is governed by the Jaitus Terms of
+Proprietary. © 2026 Lakshya Pratap Singh, trading as Jaitus. All rights reserved. Use is governed by the Jaitus Terms of
 Service at [jaitus.com/terms](https://www.jaitus.com/terms). See `LICENSE`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaitus",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Jaitus — a coding agent in your terminal.",
   "type": "module",
   "bin": {

package/src/agent/loop.js

@@ -249,7 +249,7 @@ export function repairToolPairs(messages) {
 // but not free — was ~75% of what a session cost: 109 requests averaged 46k tokens of
 // context each, most of it tool output from many steps ago (a file read at step 3 is
 // still paid for at step 60). This is the documented "clear old tool results" strategy
-// (Anthropic's context editing, clear_tool_uses; Claude Code's micro-compaction): once
+// (context editing, also known as micro-compaction): once
 // the conversation passes TRIM_AT, the outputs of all but the KEEP_RECENT latest tool
 // calls are replaced with a line saying they were cleared and can be re-run. It clears
 // at least TRIM_AT_LEAST at a time, because each clearing breaks the prompt cache once
@@ -257,14 +257,14 @@ export function repairToolPairs(messages) {
 // "file written", an exit code) are kept: they carry meaning and cost nothing.
 // 100k was the documented default for 200k-window models. Here the window is up to 1M, so
 // that ceiling was rarely near: production requests averaged 53k tokens and two thirds of
-// all input tokens came from requests over 60k. At 40k a clearing (one cache break, ~17
-// credits on glm-5.3-flash) pays for itself within about ten later requests.
+// all input tokens came from requests over 60k. At 40k a clearing (one cache break)
+// pays for itself within about ten later requests.
 export const TRIM_AT = 40_000;          // estimated tokens of conversation
 export const KEEP_RECENT = 6;           // latest tool results always kept whole
 export const TRIM_AT_LEAST = 12_000;    // estimated tokens a clearing must free
 // Past DEEP_AT only the newest KEEP_RECENT_DEEP results stay whole. Production, 7 days to
-// 2 Oct: requests carrying 150k+ tokens were a quarter of all requests and 62% of all
-// credits — every step of a long task re-sent the outputs of its last six tools whole,
+// 2 Oct: requests carrying 150k+ tokens were a quarter of all requests and most of all
+// usage — every step of a long task re-sent the outputs of its last six tools whole,
 // up to 60,000 characters each.
 export const DEEP_AT = 100_000;
 export const KEEP_RECENT_DEEP = 3;
@@ -364,10 +364,9 @@ export async function streamTurn({ client, messages, model, system, tools, onTex
   // `credits` is what the gateway counted against the plan for this request — real cost,
   // the one unit the plan, the dashboard and this CLI all show.
   const usage = { input_tokens: 0, output_tokens: 0, cache_read_input_tokens: 0, cache_creation_input_tokens: 0, credits: 0 };
-  // Usage can arrive at the START of a stream (Anthropic-format providers) or only at
-  // the END, in message_delta (OpenAI-format providers, translated by the gateway —
-  // their usage exists only once generation finishes). Reading input from message_start
-  // alone recorded every OpenAI-format turn as 0 input tokens.
+  // Usage can arrive at the START of a stream (in message_start) or only at the END, in
+  // message_delta (streams whose usage exists only once generation finishes). Reading
+  // input from message_start alone recorded every end-reported turn as 0 input tokens.
   const takeUsage = (u) => {
     if (!u) return;
     for (const k of ['input_tokens', 'output_tokens', 'cache_read_input_tokens', 'cache_creation_input_tokens', 'credits']) {
@@ -563,7 +562,7 @@ export async function runAgent({
     let streamed = false;
     const spin = tui ? { stop: () => {}, update: () => {} } : (silent ? { stop: () => {}, update: () => {} } : spinner(glyph('Working…', 'Working...')));
     if (tui) tui.setStatus(`${c.brand(glyph('•', '*'))} ${c.brand(glyph('Working…', 'Working...'))}`);
-    // Codex-style assistant cell: the • leads the turn the way › leads the
+    // Assistant cell: the • leads the turn the way › leads the
     // user's. In scrollback the marker lands before the first streamed chunk.
     let turnVoiced = false;
 
@@ -918,7 +917,7 @@ export async function runAgent({
       }
     }
 
-    // Every tool_result first, then any images, in the same user message. Anthropic's
+    // Every tool_result first, then any images, in the same user message. The message
     // format requires the results to lead the message; an image between two results
     // (read_image followed by another call in one batch) was a rejected request.
     const images = [];

package/src/api.js

@@ -17,8 +17,8 @@ export class NotSignedIn extends Error {}
 // id) instead of eternity. The caller's signal (Esc) still wins: it aborts through the
 // same controller, and only a genuine user abort reads as one.
 //
-// A turn is bounded by SILENCE, not by its length. Until the reply starts, the gateway
-// may be failing over between provider keys (each gets a 20-45 s budget), so the first
+// A turn is bounded by SILENCE, not by its length. Until the reply starts, the server
+// may still be retrying on its side (each try gets a 20-45 s budget), so the first
 // byte gets a few minutes. Once it starts, the gateway writes a heartbeat at least every
 // 10 s for as long as the provider is working, so 90 s without a single byte means the
 // connection is dead — while a long, healthy answer streams for as long as it needs.
@@ -94,7 +94,7 @@ export function createClient() {
 
   // x-jaitus-features: what this build understands, so the gateway can use newer error
   // codes (a used-up usage window) without an older CLI reading them as "went wrong".
-  const base = { 'Content-Type': 'application/json', 'user-agent': `jaitus-cli/${version()}`, 'x-jaitus-features': 'usage-window' };
+  const base = { 'Content-Type': 'application/json', 'user-agent': `jaitus-cli/${version()}`, 'x-jaitus-features': 'usage-window plan-expired' };
   // x-jaitus-device: this computer's hashed identifiers (machine.js), which the free
   // tier is limited by. Built once per process.
   const headers = (token) => ({ ...base, 'x-jaitus-device': machineHeader(), authorization: `Bearer ${token}` });