@giovannijecha/jecode 0.2.5 → 0.3.5

package/README.md

@@ -1,9 +1,31 @@
 # Jecode
 
-Jecode is a terminal coding agent. It runs as a native Rust executable and lets
-you work with an AI model on files and commands in your project.
+Jecode is a fast, efficient coding agent for your terminal. Choose a model,
+describe a task, and let it read your project, edit files, run commands and check
+the result. Tool cards and diffs show the work as it happens.
 
-![Jecode 0.1.0 startup screen in Windows Terminal](https://raw.githubusercontent.com/giovannijecha/jecode/main/docs/images/jecode-startup.png)
+![Jecode running in Windows Terminal, with its startup screen, composer and model status](https://raw.githubusercontent.com/giovannijecha/jecode/main/docs/images/jecode-startup.png)
+
+*Windows Terminal, on a pre-release build of this interface that still reports 0.2.5.*
+
+## Measured efficiency
+
+In our five-turn coding benchmark, Jecode used **21% fewer cost-weighted tokens
+than Codex** with GPT-6.1 Sol and **36% fewer than Claude Code** with Claude
+Sonnet 5.5. All runs passed 21/21 hidden acceptance tests.
+
+| Same model, high effort | Weighted token use | Active time |
+| --- | ---: | ---: |
+| Jecode vs Codex 0.166, GPT-6.1 Sol | **21% less** | 11% longer |
+| Jecode vs Claude Code 2.1.318, Sonnet 5.5 | **36% less** | **30% shorter** |
+
+One Node project, Windows, 2026-11-04: 7 vs 6 GPT runs and 4 vs 3 Claude runs.
+Jecode used account sign-in; its API-key routes were not compared. Time excludes
+two deliberate 6.5-minute pauses. Weighted tokens are a cache-aware cost proxy,
+not raw totals, API bills or plan quota.
+See the [method, per-run data and limits](https://github.com/giovannijecha/jecode/blob/main/docs/development/AGENT_BENCHMARK.md).
+
+## Install
 
 Install Jecode with Node.js 22 or later and npm:
 
@@ -12,11 +34,44 @@ npm install -g @giovannijecha/jecode
 jecode --version
 ```
 
-The npm package supports Windows x64, Linux x64 with glibc 2.39 or newer, and
-macOS on Apple silicon (verified on macOS 15). Earlier macOS versions remain
-unverified. It includes the platform executables; it does not build code or fetch
-a binary when you first run it. Node.js starts the npm command. A standalone
-build of Jecode does not need Node.js.
+The npm package supports Windows 10 1809 or later (x64), Linux x64 with glibc 2.28
+or newer, and macOS 11 or later on Apple silicon or Intel. It includes the platform
+executables; it does not build code or fetch a binary when you first run it.
+Node.js starts the npm command. A standalone build of Jecode does not need Node.js.
+On macOS 11–13.4, use Node.js 22; Node.js 24 needs macOS 13.5 or later.
+
+## Start working
+
+Run `jecode` in your project, open `/settings` and choose **Providers**. Connect
+an OpenRouter, OpenAI or Anthropic API key, or sign in with ChatGPT, then select
+a model. A Claude subscription compatibility route is also available; read the
+[provider caveat](https://github.com/giovannijecha/jecode/blob/main/docs/usage/PROVIDERS.md#claude-account).
+API keys use API billing separately from subscription plans.
+
+Press Enter to send a task, Ctrl+G to open commands while keeping your draft,
+Esc to stop a turn, and Ctrl+Q to quit. `/help` or F1 lists commands and common
+shortcuts, and `jecode resume` continues saved work. Read the
+[terminal guide](https://github.com/giovannijecha/jecode/blob/main/docs/tui/INTERFACE.md)
+for themes, tool cards, checkpoints and shortcuts.
+
+The default permission level, Workspace, confines the agent's commands to your
+project and asks before touching anything outside it; see
+[Permissions](https://github.com/giovannijecha/jecode/blob/main/docs/usage/PERMISSIONS.md)
+for what each system supports.
+
+Jecode sends your conversation, including file contents and command output the
+agent has read, to the provider you select. Your keys, account tokens,
+conversations and checkpoints are stored locally under `~/.jecode/`.
+
+The harness is one native executable written in Rust without third-party Rust
+crates. It supports prompt caching, batched file tools and prepared tool
+sequences in one request. Native HTTP connections persist between requests;
+OpenAI conversations use WebSocket with HTTP fallback. Separate
+[performance measurements](https://github.com/giovannijecha/jecode/blob/main/docs/development/PERFORMANCE.md)
+record lower first-update latency on Windows; the comparison above predates
+that work.
+
+## Update or remove
 
 Update the npm installation with:
 
@@ -36,5 +91,6 @@ installed Jecode from source, check which `jecode` command appears first on
 `PATH`; npm does not remove that separate installation.
 
 See the [installation guide](https://github.com/giovannijecha/jecode/blob/main/docs/usage/INSTALLATION.md)
-for source installation and troubleshooting, and the [command-line guide](https://github.com/giovannijecha/jecode/blob/main/docs/usage/CLI.md)
-for usage.
+for source installation and troubleshooting, the [command-line guide](https://github.com/giovannijecha/jecode/blob/main/docs/usage/CLI.md)
+for usage, and the [release notes](https://github.com/giovannijecha/jecode/blob/main/CHANGELOG.md)
+for what changed.

package/bin/jecode.cjs

@@ -5,7 +5,7 @@ const { spawn } = require('node:child_process');
 const { existsSync } = require('node:fs');
 const { constants } = require('node:os');
 const path = require('node:path');
-const { targetFor } = require('./targets.cjs');
+const { targets, targetFor } = require('./targets.cjs');
 
 function signalExitCode(signal) {
   const number = constants.signals[signal];
@@ -13,7 +13,8 @@ function signalExitCode(signal) {
 }
 
 function glibcMeetsMinimum(version, minimum) {
-  if (!/^\d+\.\d+$/.test(version)) return false;
+  // Development builds report a third part, such as Fedora Rawhide's 2.40.9000.
+  if (!/^\d+\.\d+(?:\.\d+)*$/.test(version)) return false;
   const [major, minor] = version.split('.').map(Number);
   const [requiredMajor, requiredMinor] = minimum.split('.').map(Number);
   return major > requiredMajor || (major === requiredMajor && minor >= requiredMinor);
@@ -29,7 +30,7 @@ function launch({
   if (!target) {
     runtime.stderr.write(
       `jecode: unsupported platform ${runtime.platform}-${runtime.arch}. ` +
-      'Supported: win32-x64, linux-x64, darwin-arm64.\n',
+      `Supported: ${Object.keys(targets).join(', ')}.\n`,
     );
     runtime.exitCode = 1;
     return null;

package/bin/targets.cjs

@@ -6,19 +6,28 @@ const targets = Object.freeze({
     arch: 'x64',
     binary: 'jecode.exe',
     identity: 'windows-x86_64',
+    windowsBuildMinimum: 17763,
   }),
   'linux-x64': Object.freeze({
     platform: 'linux',
     arch: 'x64',
     binary: 'jecode',
     identity: 'linux-x86_64',
-    glibcMinimum: '2.39',
+    glibcMinimum: '2.28',
   }),
   'darwin-arm64': Object.freeze({
     platform: 'darwin',
     arch: 'arm64',
     binary: 'jecode',
     identity: 'macos-aarch64',
+    macosMinimum: '11.0',
+  }),
+  'darwin-x64': Object.freeze({
+    platform: 'darwin',
+    arch: 'x64',
+    binary: 'jecode',
+    identity: 'macos-x86_64',
+    macosMinimum: '11.0',
   }),
 });
 

package/native/manifest.json

@@ -1,48 +1,89 @@
 {
   "format": 1,
-  "version": "0.2.5",
-  "revision": "bf5169b7b41ca59f5d902c6e40390418c898b90a",
+  "version": "0.3.5",
+  "revision": "e6eda74d74093ef29efb6bc14c3976fe99b86ce6",
   "artifacts": [
     {
       "format": 1,
-      "version": "0.2.5",
-      "revision": "bf5169b7b41ca59f5d902c6e40390418c898b90a",
+      "version": "0.3.5",
+      "revision": "e6eda74d74093ef29efb6bc14c3976fe99b86ce6",
       "sourceClean": true,
       "target": "win32-x64",
       "binary": "jecode.exe",
-      "bytes": 11251712,
-      "sha256": "2e8dfc670c13afe283bf266095ef9823bc4aa0881cf6c878232c7313a333b75a"
+      "bytes": 12940288,
+      "sha256": "f40ddac2242d026730ac91818289ac70c7f412131e55348f85c27b85fac939c5",
+      "windowsBuildMinimum": 17763,
+      "abiCheckedFiles": [
+        "jecode-checkpoint_space.exe",
+        "jecode-http.exe",
+        "jecode-openai_crypto.exe",
+        "jecode-pty.exe",
+        "jecode-shell.exe",
+        "jecode-supervisor.exe",
+        "jecode-terminal.exe",
+        "jecode.exe"
+      ]
     },
     {
       "format": 1,
-      "version": "0.2.5",
-      "revision": "bf5169b7b41ca59f5d902c6e40390418c898b90a",
+      "version": "0.3.5",
+      "revision": "e6eda74d74093ef29efb6bc14c3976fe99b86ce6",
       "sourceClean": true,
       "target": "linux-x64",
       "binary": "jecode",
-      "bytes": 14430448,
-      "sha256": "021559bbdf407cdbd923e38b57138c599a0f15577a3131b813bc0629efe888ef",
-      "glibcMinimum": "2.39",
+      "bytes": 16160976,
+      "sha256": "5fdbe42fe1c542f013d791881deaa484a6eb15edcfd92c784ab20df7931bbb02",
+      "glibcMinimum": "2.28",
       "abiCheckedFiles": [
-        "jecode",
         "jecode-clipboard_linux",
         "jecode-http",
         "jecode-openai_crypto",
         "jecode-process_unix",
         "jecode-pty_unix",
         "jecode-shell",
-        "jecode-terminal_unix"
+        "jecode-terminal_unix",
+        "jecode"
       ]
     },
     {
       "format": 1,
-      "version": "0.2.5",
-      "revision": "bf5169b7b41ca59f5d902c6e40390418c898b90a",
+      "version": "0.3.5",
+      "revision": "e6eda74d74093ef29efb6bc14c3976fe99b86ce6",
       "sourceClean": true,
       "target": "darwin-arm64",
       "binary": "jecode",
-      "bytes": 8947840,
-      "sha256": "8c9b49ddf988d4821e85422b1ec41702e4c98bfd2cb3a3f46bfd858dc4e74915"
+      "bytes": 10471040,
+      "sha256": "1566b4890b34eca8a541ab27b14436608b4c67901f4f25f69f5470b7d229ae54",
+      "macosMinimum": "11.0",
+      "abiCheckedFiles": [
+        "jecode-http",
+        "jecode-openai_crypto",
+        "jecode-process_unix",
+        "jecode-pty_unix",
+        "jecode-shell",
+        "jecode-terminal_unix",
+        "jecode"
+      ]
+    },
+    {
+      "format": 1,
+      "version": "0.3.5",
+      "revision": "e6eda74d74093ef29efb6bc14c3976fe99b86ce6",
+      "sourceClean": true,
+      "target": "darwin-x64",
+      "binary": "jecode",
+      "bytes": 11381040,
+      "sha256": "689efcbaa1251cf392d260857f54647458149570f402759ecc57b1815bcb2eb1",
+      "macosMinimum": "11.0",
+      "abiCheckedFiles": [
+        "jecode-http",
+        "jecode-openai_crypto",
+        "jecode-process_unix",
+        "jecode-pty_unix",
+        "jecode-shell",
+        "jecode-terminal_unix",
+        "jecode"
+      ]
     }
   ]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@giovannijecha/jecode",
-  "version": "0.2.5",
-  "description": "A terminal coding agent in Rust",
+  "version": "0.3.5",
+  "description": "A fast, efficient terminal coding agent in Rust",
   "license": "MIT",
   "author": "Giovanni Jecha",
   "repository": {