@leftoff/cli 0.8.0 → 0.8.3

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 What changed in Leftoff (called Checkpoints until 0.4.5), newest first. The board's **What's new** page and `leftoff changelog` both read this file.
 
+## [0.8.3] - 2026-10-12
+
+### Added
+- `leftoff doctor` gives the fix: every problem line gets a `fix:` line with the exact command. `leftoff doctor --fix` runs the safe ones (restarts, never installs or deletes), asking first.
+- **Low disk warning** before Syncthing stops syncing, on the board and in doctor. When sync has stopped, or another Mac has gone quiet, a sync chip says so, and that Mac's sessions show "as of" when they were last synced.
+- Opening the board from another computer offers the one line to set up Leftoff there too.
+
+### Fixed
+- Closed: a repo filter always shows as a chip you can remove, All counts every closed session, sessions started outside a repo are "No repo" (not "/"), and a repo is named after its git remote, not its folder.
+
+## [0.8.2] - 2026-10-12
+
+### Added
+- `/cp-park [note]`: checkpoint, park the session to come back to, and exit. Parked sessions get their own section on the board and a line in the digest, and resuming one unparks it. Also Park on a session's page (Codex too) and `leftoff park`.
+
+## [0.8.1] - 2026-10-12
+
+### Fixed
+- Settings → About links to npm, the security and feed-hosting docs open right in the board, and the "not installed yet" hints use `npx -y -p @leftoff/cli leftoff`. Codex cards count their turns instead of showing "0 turns".
+
 ## [0.8.0] - 2026-10-12
 
 ### Added
@@ -234,7 +254,7 @@ What changed in Leftoff (called Checkpoints until 0.4.5), newest first. The boar
   - The footer under each item is short and accurate: "From Tab · reply by texting Tab", using `agent.replyHint` (new, optional, up to 120 characters), or "From Tab · Read-only here" without one.
   - The digest and Catch me up mention a reply only when the feed gives one. Catch-ups saved by 0.5.4/0.5.5 still read back.
   - Leftoff 0.5.5 and older reject a feed with `agent.reply` (strict schema). Upgrade before your agent adds it.
-- **The GitHub repo is now `OneSillyApp/leftoff`** (it was `joelash/checkpoints`, briefly `joelash/leftoff`). Install and upgrade lines (`npx github:OneSillyApp/leftoff setup`), the join line for a new Mac, and links in the board and the docs all use the new name. The npm package name stays `checkpoints`. The old names keep working everywhere they're read: GitHub redirects both, and Leftoff maps `joelash/checkpoints` and `joelash/leftoff` (as `owner/repo`, `github:`, https, `git@` or `ssh://`) to the new name. So an install that recorded an old source upgrades from the new one, and `leftoff upgrade` on a git clone also points its `origin` at the new URL.
+- **The source repo moved to its new name.** Install and upgrade lines, the join line for a new Mac, and links in the board and the docs all use it. The old names keep working everywhere they're read: Leftoff maps them (as `owner/repo`, `github:`, https, `git@` or `ssh://`) to the new one, so an install that recorded an old source upgrades from the new one, and `leftoff upgrade` on a git clone also points its `origin` at the new URL.
 
 ### Tests
 - New `test/agents-hosting-e2e.mjs` (9): keygen → the real Worker template on loopback → publish (invalid refused, wrong key 403, dry run) → read keys, 401s, ETag/weak ETag/304 → `leftoff agents add` → an update that drops `agent.reply`.
@@ -298,7 +318,7 @@ Before a device is accepted, Syncthing passes on only what's in its Hello: ID, n
 - **Easy Syncthing.** Settings → Sync now gets Syncthing working in a few clicks, without opening Syncthing:
   1. **Install Syncthing (recommended).** It shows the exact command (`brew install syncthing && brew services start syncthing`) and runs it only after you click Install. Homebrew's output streams into the page, and a failure gets a plain sentence ("Homebrew couldn't download Syncthing…") and **Try again**. Without Homebrew you get two short directions and **Check again**. Leftoff uses the formula with `brew services` (a background login service) rather than the menu-bar app.
   2. **Sync this folder.** It does the verified move into `~/Sync/Leftoff` (or `~/Leftoff` when `~/Sync` is another Syncthing folder, or your pick), then adds a Syncthing folder with the ID `leftoff` through Syncthing's local API, plus a `.stignore`.
-  3. **Pair another Mac.** You get a one-time code (15 minutes, works once). On the other Mac: `leftoff join <code>`, `npx -y github:joelash/checkpoints join <code>`, or **Join another Mac** on its board. It installs or starts Syncthing (asking first), adds your first Mac, and is accepted automatically, but only because it proves it holds the code. You see *Waiting for studio…*, *Syncing 214/530 files…* and *Done*, and then its sessions are merged in.
+  3. **Pair another Mac.** You get a one-time code (15 minutes, works once). On the other Mac: `leftoff join <code>` (or the `npx` line shown next to it, if Leftoff isn't installed there yet), or **Join another Mac** on its board. It installs or starts Syncthing (asking first), adds your first Mac, and is accepted automatically, but only because it proves it holds the code. You see *Waiting for studio…*, *Syncing 214/530 files…* and *Done*, and then its sessions are merged in.
 - **Status:** Settings → Sync, `leftoff sync` and `leftoff doctor` show whether Syncthing is running, the peers that are connected (and how far along they are), the last sync and folder errors. **Stop syncing** (`leftoff sync stop`) removes the Leftoff folder from Syncthing and keeps the files.
 - **CLI:** `leftoff sync [install|start|setup|pair|stop]` and `leftoff join <code>`.
 - **Security notes:** [docs/SECURITY.md](docs/SECURITY.md) covers what's in the folder, where it lives with Syncthing, iCloud, Dropbox or another folder, what never syncs, the pairing trust model, cross-machine commands, phone access, and what Leftoff doesn't protect against. A short "How your data is protected" panel appears in the sync walkthrough and in Settings → Other machines.
@@ -474,7 +494,7 @@ Run `checkpoints upgrade` (or `leftoff upgrade` once it's installed), then resta
 - **Login service:** macOS's `dev.checkpoints.daemon` LaunchAgent is unloaded and removed, and replaced with `dev.leftoff.daemon` (still `ProcessType Interactive`, on the same folder). On Linux, `checkpoints.service` becomes `leftoff.service`. Exactly one daemon runs afterwards.
 - **The mod:** `checkpoints@checkpoints` is uninstalled and `leftoff@checkpoints` is installed from the same marketplace. If you had disabled it, it stays disabled.
 - **Settings hooks (hooks-only mode):** the `--tag=checkpoints-hook` entries are replaced with `--tag=leftoff-hook` ones, one per event with no duplicates. Hooks of your own in the same file are left alone. Until you upgrade, the old entries keep working, because `checkpoints` is still installed.
-- **The GitHub repo and install line are unchanged** for now: `npm i -g github:joelash/checkpoints`. The npm package keeps its internal name `checkpoints`, because npm won't install a package called `leftoff` over one that owns the `checkpoints` command. It installs both commands.
+- **The install line is unchanged** for now. The npm package keeps its internal name `checkpoints`, because npm won't install a package called `leftoff` over one that owns the `checkpoints` command. It installs both commands.
 - `leftoff doctor` points out anything still using an old name (the login service or settings hooks).
 
 ## [0.4.4] - 2026-10-10
@@ -588,13 +608,13 @@ Run `checkpoints upgrade` (or `leftoff upgrade` once it's installed), then resta
 ## [0.3.3] - 2026-10-09
 
 ### Fixed
-- **`checkpoints upgrade` said "Authentication failed" on a private repo when your GitHub login is SSH.** The update check and `upgrade` try `https://github.com/…` first and now fall back to `git@github.com:…` over SSH. You can also pin it with `"updates": { "source": "git@github.com:joelash/checkpoints.git" }` in config.json.
+- **`checkpoints upgrade` said "Authentication failed" on a private repo when your GitHub login is SSH.** The update check and `upgrade` try `https://github.com/…` first and now fall back to `git@github.com:…` over SSH. You can also pin it with `"updates": { "source": "git@github.com:<owner>/<repo>.git" }` in config.json.
 - GitHub now marks `bin/checkpoints.js` executable, which fixes `permission denied: checkpoints` after `npm link` in a fresh clone.
 
 ## [0.3.2] - 2026-10-09
 
 ### Fixed
-- **`npm i -g github:joelash/checkpoints` failed with `ENOTDIR` (git dep preparation failed).** A `prepare` script made npm run a nested install for the git dependency, and under `-g` that nested install tried to install globally too. The script is gone. `setup` and `upgrade` record the installed commit themselves.
+- **Installing from git with `npm i -g` failed with `ENOTDIR` (git dep preparation failed).** A `prepare` script made npm run a nested install for the git dependency, and under `-g` that nested install tried to install globally too. The script is gone. `setup` and `upgrade` record the installed commit themselves.
 
 ## [0.3.1] - 2026-10-09
 
@@ -626,7 +646,7 @@ Run `checkpoints upgrade` (or `leftoff upgrade` once it's installed), then resta
 ## [0.2.0] - 2026-10-09
 
 ### Added
-- **One-command setup:** `npx github:joelash/checkpoints setup`. It checks Node and Claude Code, installs the mod with `claude plugin`, helps you pick a summarizer, starts the daemon and opens the board. It's safe to re-run.
+- **One-command setup** with `npx`. It checks Node and Claude Code, installs the mod with `claude plugin`, helps you pick a summarizer, starts the daemon and opens the board. It's safe to re-run.
 - **Local models in setup:** finds Ollama or LM Studio, offers to install Ollama, suggests four small models with their sizes, pulls your pick with a progress bar and writes a sample checkpoint so you can see the result.
 - `checkpoints models` lists, pulls, switches and tests local models later.
 - `--yes` and flags let you script setup.

package/README.md

@@ -1,30 +1,57 @@
 # Leftoff
 
-**WTF was I working on?** Leftoff watches your Claude Code sessions, writes a
-3-line checkpoint when one goes quiet, and gives you a morning digest and a
-board of everything you had open, on every Mac you use.
+**WTF was I working on?** Leftoff watches your Claude Code (and Codex)
+sessions, writes a 3-line checkpoint when one goes quiet, and gives you a
+morning digest and a board of everything you had open, on every Mac you use.
 
 ```sh
-npm i -g @leftoff/cli
-leftoff setup
+npm i -g @leftoff/cli && leftoff setup
 ```
 
-(`pnpm add -g @leftoff/cli` works too; the command is `leftoff`.) Setup takes about two minutes: it installs
-the Claude Code plugin, picks a summarizer and starts a small local daemon with
-a web board at http://127.0.0.1:7429. GitHub's `gh` is optional: with it
-signed in, a card that needs you also shows the branch's pull request.
+(`pnpm add -g @leftoff/cli` works too; the command is `leftoff`.) Setup takes
+about two minutes: it installs the Claude Code plugin, picks a summarizer and
+starts a small local daemon with a web board at http://127.0.0.1:7429.
 
-Want your board on your phone? Claim your own address:
+## What it does
+
+- **Board:** every session, open or closed, by repo, with what it's doing now.
+- **Needs you:** sessions waiting on an answer or an OK, answerable from the board.
+- **Checkpoints and digest:** a short note when a session goes quiet, and a daily recap.
+- **To do and Files:** steps a session handed back to you, and the docs, plans and artifacts it made.
+- **PRs:** the pull requests your sessions opened, and your team's open ones (with GitHub's `gh`, optional).
+- **Resume:** closed sessions are one tap from coming back.
+- **Phone:** your board at your own address, end-to-end encrypted.
+
+## Commands
 
 ```sh
-leftoff relay signup yourname
+leftoff setup            # set up or change settings
+leftoff open             # open the board
+leftoff status           # sessions and their status
+leftoff go [name]        # jump to a session's terminal tab
+leftoff restore          # reopen what was open before a restart
+leftoff catchup          # one recap across repos
+leftoff park [session] [note]   # park a session to come back to
+leftoff relay signup yourname   # your board on your phone, at yourname.leftoff.dev
+leftoff upgrade          # update
+leftoff doctor           # check the install; each problem comes with its fix
+leftoff doctor --fix     # run the safe fixes, asking first
+leftoff --help           # everything else
 ```
 
-- What it is: https://leftoff.dev
-- How it works: https://leftoff.dev/how-it-works
-- Update: `leftoff upgrade`
+In a Claude Code session:
 
-Everything Leftoff writes is plain Markdown in a folder you choose. The hosted
-board is end-to-end encrypted between your phone and your Macs.
+```text
+/cp [note]          checkpoint now
+/cp-name <title>    name the session
+/cp-park [note]     checkpoint, park it on the board, and exit (the note is where to pick up)
+/leftoff            every open session
+```
+
+Everything Leftoff writes is plain Markdown in a folder you choose.
+
+- Website: https://leftoff.dev
+- How it works: https://leftoff.dev/how-it-works
+- Questions: hello@leftoff.dev
 
 Proprietary for now (see LICENSE.md); a source-available license is planned.