@shllg/emend 0.1.0 → 0.3.0

package/README.md

@@ -43,8 +43,7 @@ one-time sign-in link. The two `claude plugin` lines add the skills to Claude Co
 If `node --version` is older than 24.18 or `git --version` older than 2.44, as on many Linux
 distributions and with Apple's git on macOS, follow step 1 of
 [local.md](https://github.com/shllg/emend/blob/release/docs/setup/local.md#1-install-nodejs-and-git)
-first. If your agents run in a sandbox, read
-[Use with sandboxed agents](https://github.com/shllg/emend#use-with-sandboxed-agents) next.
+first.
 
 The full walkthrough, with a prompt that lets Claude Code or Codex do it with you, is
 [docs/setup/local.md](https://github.com/shllg/emend/blob/release/docs/setup/local.md).
@@ -60,7 +59,8 @@ one-prompt setup.
 | [One machine](https://github.com/shllg/emend/blob/release/docs/setup/local.md) | You try emend or review agent work on the machine where the agents run. |
 | [Your own hub on Tailscale](https://github.com/shllg/emend/blob/release/docs/setup/hub-tailscale.md) | You have an always-on machine and want to review from your phone and other devices. |
 | [Attach more machines](https://github.com/shllg/emend/blob/release/docs/setup/attach.md) | You run a hub and want the agents on your other machines to publish to it. |
-| [Set up your agents](https://github.com/shllg/emend/blob/release/docs/setup/agents.md) | emend runs and you want Claude Code, Codex or others to use it, sandbox rules included. |
+| [Set up your agents](https://github.com/shllg/emend/blob/release/docs/setup/agents.md) | emend runs and you want Claude Code, Codex or others to use it. |
+| [Develop emend from a checkout](https://github.com/shllg/emend/blob/release/docs/setup/development.md) | You change emend itself or run it from a clone. |
 | [Update](https://github.com/shllg/emend/blob/release/docs/setup/update.md) | A new version is out. |
 | [Troubleshooting](https://github.com/shllg/emend/blob/release/docs/setup/troubleshooting.md) | A setup or update step fails. |
 | A hub on your own network (a LAN address or your own HTTPS proxy) | Not supported yet; planned. Today Tailscale is the supported way to reach a hub from other devices. |
@@ -74,24 +74,14 @@ claude plugin update emend@emend
 ```
 
 With mise, run `mise upgrade npm:@shllg/emend` instead of the `npm` line. If you installed the
-service, run `emend service install` again; it keeps its options. If you ran `emend skills install`
+service, run `emend service install` again; it keeps its options. Without the service, run
+`emend stop`; the next `emend` starts the new version. If you ran `emend skills install`
 before, run it again. Then restart Claude Code. After `brew upgrade node` or `mise upgrade node`,
 run `emend service install` again too.
 
 [docs/setup/update.md](https://github.com/shllg/emend/blob/release/docs/setup/update.md) covers the
 order for a hub and its machines, Node.js upgrades and the phone app.
 
-## Use with sandboxed agents
-
-Inside an agent's sandbox, `emend publish`, `wait`, `feedback` and `reply` cannot reach the
-emend server or write its state folder, and emend prints a line that points here. Step 3 of
-[docs/setup/agents.md](https://github.com/shllg/emend/blob/release/docs/setup/agents.md#3-use-with-sandboxed-agents)
-says how to let exactly these four commands leave the sandbox, once per machine. Read what that
-allows, and when not to add it, before you do: these commands then run with your full rights.
-Add them only when `emend` on your `PATH` is an install no agent can write, never a development
-checkout. The rules never cover `pair`, `attach` or `detach`, so an agent cannot pair a device or
-attach your machine to a hub.
-
 ## Uninstall
 
 Remove what a setup added with its Undo section: [one machine](https://github.com/shllg/emend/blob/release/docs/setup/local.md#undo)
@@ -105,40 +95,11 @@ and publishing docs for review.
 
 ## Development
 
-A checkout installs the same way as a release: `pnpm install:local` builds the committed `HEAD` in
-a temporary folder, packs it and installs the package. Use a clone that no agent or tool writes to,
-review a change before you pull it, and run the command again after each pull.
-
-```sh
-pnpm install
-pnpm install:local
-```
-
-If you linked `apps/emend/bin/emend` into a folder on your `PATH` before (the earlier development
-steps and `install.sh` did), remove that link, and stop every emend server that runs from a
-checkout: `pgrep -af '[e]mend.mjs serve'` lists them with their paths (`pgrep -lf` on macOS).
-Otherwise the commands your agents run outside their sandbox, and the server that serves the review
-app, run the checkout's build, which agents can change.
-
-With mise on your `PATH`, the package goes to a folder in mise's data folder that `mise link`
-registers as `npm:@shllg/emend@local`; pass `--npm` to use `npm install -g` instead. If `emend` is
-not on your `PATH` yet, the command prints the folder to add. It also restarts an installed
-service, so the new build runs.
-
-For Claude Code, add the checkout as a plugin marketplace instead of the GitHub one, never both:
-
-```text
-/plugin marketplace add <path to your checkout>
-/plugin install emend@emend
-```
-
-Claude Code reads the skills from the checkout's `plugin/` folder, uncommitted changes included. A
-pulled change takes effect at the next session start or after `/reload-plugins`. For other agents,
-run `emend skills install` once; its links point into the installed package.
-
-`pnpm verify` runs every check. [AGENTS.md](https://github.com/shllg/emend/blob/main/AGENTS.md)
-holds the working rules. Maintainers: [docs/releasing.md](https://github.com/shllg/emend/blob/main/docs/releasing.md)
-holds the release policy and checklist.
+[Develop emend from a checkout](https://github.com/shllg/emend/blob/release/docs/setup/development.md)
+covers installing from a checkout, the plugin from a checkout and the checks.
+[AGENTS.md](https://github.com/shllg/emend/blob/main/AGENTS.md) holds the working rules.
+Maintainers: [docs/releasing.md](https://github.com/shllg/emend/blob/main/docs/releasing.md) holds
+the release policy and checklist.
 
 ## License