@joule-sh/code-darwin-arm64 0.23.4 → 0.23.6

package/README.md

@@ -1,184 +1,65 @@
-# code
+# joule
 
-An agentic coding terminal you can also drive from a web page.
+An AI coding agent that runs in your terminal and can be driven from a browser.
 
-You run it in a repo on your own machine. It prints a short pairing code. You
-open the page, enter the code, and from then on the browser and the terminal are
-the same session. You start work at the desk and keep steering it from a laptop
-or a phone.
+Pre-1.0.
 
-The agent reads and edits files, runs commands and makes commits **on your
-machine**. The browser is a remote control, never an executor.
-
-## Status
+## Install
 
-v0 is in progress. Landed: the repo skeleton and CI
-([#1](https://github.com/joule-sh/code/issues/1)), the shared frame protocol
-([#2](https://github.com/joule-sh/code/issues/2)), the release pipeline
-([#13](https://github.com/joule-sh/code/issues/13), install mechanics only).
-Not yet: the turn loop, a model provider, the file and run tools, approval,
-the terminal front end, the relay, and the web page. There is no working demo
-until those land, the install below gets you the v0 skeleton, not a usable
-tool.
+macOS and Linux:
 
-- [docs/00-plan.md](docs/00-plan.md): architecture, the decisions and what
-  forced them, and the order the work goes in.
-- [specs/](specs/): one directory per decided piece, in the same numbered form
-  the Lumen repo uses.
-- [The v0 milestone](https://github.com/joule-sh/code/milestone/1) holds the
-  tickets. [#15](https://github.com/joule-sh/code/issues/15) is the plan,
-  [#1](https://github.com/joule-sh/code/issues/1) is where the code starts.
+```sh
+curl -fsSL https://raw.githubusercontent.com/joule-sh/code/main/install.sh | sh
+```
 
-## Install
+Windows, or any platform, from npm:
 
 ```sh
 npm i -g @joule-sh/code
 ```
 
-or, with no Node on the machine:
+Both install `joule` and `relay` at the same version, and run every binary
+before reporting success. Runs as `joule`, not `code`. It offers to update
+itself; there is no update command.
 
-```sh
-curl -fsSL https://raw.githubusercontent.com/joule-sh/code/main/install.sh | sh
-```
+Prebuilt for x86_64 Linux, Apple Silicon macOS, Intel macOS and x86_64 Windows,
+and every release carries the plain archives too, including
+`code-x86_64-windows.zip`. Other platforms need
+[building from source](docs/07-building.md).
 
-Both put the same two commands on your `PATH` at the same version, and both
-run every binary before reporting success. npm pins and uninstalls cleanly;
-the script needs nothing installed first. The npm package is a wrapper whose
-binaries live in `@joule-sh/code-linux-x64`, `@joule-sh/code-darwin-x64`,
-`@joule-sh/code-darwin-arm64` and `@joule-sh/code-win32-x64`, installed as
-optional dependencies so npm takes only the one that matches. `install.sh` has
-no Windows counterpart: npm is the way in there, or the
-`code-x86_64-windows.zip` a release publishes.
-
-Installs as `joule`, not `code` - `code` is already taken by VS Code's CLI on
-most machines, and this project would silently shadow or lose to it depending
-on `PATH` order. Prebuilt for x86_64 Linux, Apple Silicon macOS
-(`aarch64-macos`), Intel macOS (`x86_64-macos`) and x86_64 Windows; other
-platforms fail with a clear message and point at building from source below.
-
-Every archive carries the garbage collector it needs, so there is no library to
-install alongside it. A macOS binary needs nothing beyond the system's own
-libSystem. A Linux binary is linked statically against musl and needs nothing
-at all - no libc version, no loader, no shared library - so it runs the same on
-Ubuntu 22.04, on a decade-old enterprise release and on Alpine. The installer
-runs each binary before it links anything onto your `PATH`, so an install that
-reports success is one that runs, and an install that cannot says what stopped
-it.
-
-## Build from source
-
-Requires the [Lumen](https://lumen-lang.org) toolchain (`lumen`, and `zig`
-alongside it on `PATH`, as the release archive ships them). Lumen publishes
-macOS builds too (`lumen-aarch64-macos.tar.gz`, `lumen-x86_64-macos.tar.gz`),
-so this works natively on a Mac.
-
-Lumen's allocator links the Boehm collector as a system library. Linux distros
-ship it as `libgc` and a local build needs nothing extra. macOS has no system
-copy, so a Mac build needs Homebrew's and has to point the compiler at it:
+## Start it
 
-```sh
-brew install bdw-gc
-make build LUMEN_FLAGS="--link -L$(brew --prefix bdw-gc)/lib"
-```
+Run `joule` in a directory you want to work in. It reads and edits files, runs
+commands and makes commits there, on your machine.
 
-The `-L` is not optional on Intel Macs. Zig ignores `LIBRARY_PATH` on macOS and
-only has Apple Silicon's `/opt/homebrew` in its built-in search paths, so an
-Intel build fails without it.
+`/help` lists the commands. `joule --continue` reopens the most recent session
+for that directory.
 
-The release archives link that library statically on both platforms, so an
-installed release carries it. macOS uses Homebrew's `libgc.a`. Linux names a
-target instead, which links musl and a collector the compiler builds for that
-target, leaving a binary with nothing to resolve. To reproduce what a Linux
-release ships:
+## Connect a model
 
-```sh
-make release LUMEN_TARGET=x86_64-linux-musl
-scripts/check_linux_release.sh bin/joule bin/relay bin/joule-daemon
-```
+- A joule.sh account - run `/login`
+- Your own provider key - `baseUrl` and `apiKey` in
+  `~/.config/joule-code/config.json`
+- Your own server - `--server` or `JOULE_CODE_SERVER`
 
-`LUMEN_TARGET` also compiles the vendored `tty_shim.o` for that target, so
-switch it on a tree that was already built and `make clean` first.
+## The editor extension
 
-```sh
-git clone https://github.com/joule-sh/code.git
-cd code
-make build
-./bin/joule --version
-```
+A panel in VS Code. Install
+[`joule-sh.joule-editor`](https://marketplace.visualstudio.com/items?itemName=joule-sh.joule-editor)
+from the marketplace, or the `.vsix` a release attaches. Not on Open VSX.
+Install `joule` first; [editor/README.md](editor/README.md) has the settings.
+
+## Share it to a browser
+
+`/share` prints a URL and a six-character code. The session appears in the
+console as a conversation you can read and reply in from any browser - nothing
+runs in the browser. A console signed in to the account that shared it needs no
+code.
 
-`make test` runs the test suite, `make release` builds the `--release-fast`
-binaries the release workflow packages.
-
-## The one invariant
-
-**The terminal is authoritative.** It holds the workspace, the history and the
-tool loop. The relay pairs a browser to a terminal, forwards frames both ways,
-and keeps a bounded replay buffer. Nothing more. It never runs a tool, never
-holds a checkout, and stores nothing durable. If the relay dies the terminal
-keeps working; you lose the web view, not the work.
-
-Every design question in v0 is answered by pushing state toward the terminal.
-
-## Built in Lumen
-
-CLI, relay and the page the relay serves. Two binaries, one language.
-
-The terminal and the browser each hold one WebSocket to the relay, using the
-`websocket` package from std-contrib. The model is read over SSE with
-`http.stream`, because that is what providers speak. The reasoning, including
-the concurrency problem a blocking `receive()` creates for the terminal, is in
-[spec 003](specs/003-transport/spec.md).
-
-## Honest limits (v0)
-
-No hosted sandbox, the agent only ever runs on your own machine. No multi-agent,
-no subagents, no MCP. See [docs/00-plan.md](docs/00-plan.md) for the reasoning
-behind each.
-
-Conversation history is saved per workspace as you go and picked back up with
-`joule --continue`, which resumes the most recent session for the current
-directory. Model, mode and workspace are not part of what gets saved - they
-are re-resolved fresh from the normal config chain on every launch. There is
-no picker for older sessions yet, only the most recent one.
-
-The terminal does its own mouse selection, so the wheel and drag-to-select
-both work at once rather than trading against each other. The wheel scrolls
-the transcript, PageUp/PageDown scroll it too, and dragging over the
-transcript selects the rows the drag covers - drawn in reverse video, with the
-status line saying how many lines are held. The wheel keeps scrolling while a
-drag is in progress: the selection stays on the text it was drawn over rather
-than on the screen rows.
-
-Releasing copies. Joule is a local process, so it writes the clipboard itself
-rather than asking your terminal to: `pbcopy` on macOS, `wl-copy` on Wayland,
-`xclip` or `xsel` on X11, `clip.exe` on Windows. That works on every terminal,
-including the ones that refuse OSC 52 clipboard writes by default and the ones
-that never implemented it. The status line then reports a copy that really
-happened: `copied 3 lines - Esc clears`.
-
-Over ssh the local clipboard is the wrong one - the one you paste into is at
-your end of the connection - so a remote session falls back to OSC 52
-(`ESC ] 52 ; c ; <base64> BEL`), which travels back over the terminal. So does
-a machine with no clipboard command installed. A terminal that refuses OSC 52
-sends no reply, so there is nothing to detect and nothing to retry, and the
-status line says only what it can stand behind: `asked the terminal for 3
-lines - /mouse off if nothing pasted`. If the clipboard command is there and
-fails, nothing is claimed at all: `no clipboard here - Esc clears - /mouse off
-to select with the terminal`. `/mouse` on its own names which of the three
-this machine will use.
-
-Escape clears the selection, typing puts the status line back, and the next
-click starts a new one.
-
-A click that does not move copies nothing, the way it behaves in an editor.
-Sign-in codes are never selectable: the row map covers transcript rows only,
-and no selection can start, extend or copy while the input line is capturing.
-
-`/mouse off` hands selection back to your terminal's own, for anyone who
-prefers it or whose machine can reach no clipboard at all; the button events
-are then ignored outright. It writes `"mouse": "off"` into `~/.config/joule-code/config.json`,
-`/mouse on` puts it back, and `JOULE_CODE_MOUSE` overrides the file for a
-single run.
-
-Copying from a collapsed tool-output group only copies what is visible; the
-rows hidden by the collapse are not part of the selection.
+## Docs
+
+- [docs/00-plan.md](docs/00-plan.md): architecture, the decisions and what
+  forced them.
+- [docs/06-selection.md](docs/06-selection.md): mouse selection and copy.
+- [docs/07-building.md](docs/07-building.md): building from source.
+- [specs/](specs/): one directory per decided piece.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joule-sh/code-darwin-arm64",
-  "version": "0.23.4",
+  "version": "0.23.6",
   "license": "MIT",
   "repository": {
     "type": "git",