@mrciphersmith/keryx 0.3.43 → 0.3.46

package/README.md

@@ -73,9 +73,15 @@ keryx health run --changed   # normalized health report
 keryx dash                   # human admin dashboard
 ```
 
-`keryx init` creates the `.metaproject/` workspace and connects your existing
-`AGENTS.md` / `CLAUDE.md` entrypoints to it, so agents are routed to the right
-module automatically.
+`keryx init` creates the `.metaproject/` workspace and connects your agents to
+it, so they are routed to the right module automatically. It imports your
+`AGENTS.md` / `CLAUDE.md` as project rules and writes its routing block and
+Claude hooks to per-developer, gitignored files (`CLAUDE.local.md`,
+`AGENTS.override.md`, `.claude/settings.local.json`, ignore rules in
+`.git/info/exclude`), so the files your team tracks stay untouched and
+`git pull` never meets an edit made by keryx. A team that wants the block committed opts
+into `scope: "shared"`; see
+[where the block goes](docs/docs/workspace-and-lifecycle.md#where-the-block-goes-local-and-shared-scope).
 
 ### Connect a model provider
 
@@ -123,6 +129,9 @@ described [below](#the-agent-harness). A few commands worth knowing from the
 first session:
 
 - `/theme [name]` opens the theme picker; a choice applies immediately.
+- `/settings` opens one modal with the permission mode, plan, guards, routing,
+  reasoning, theme and external switches, each with its On/Off or value
+  buttons; `/mode` and `/plan` are marked `session`, the rest `saved`.
 - `/mode [ask|trust|auto]` shows or switches the permission mode for the rest
   of the session — see [permission modes](docs/docs/guides/permission-modes.md).
 - `/help` lists every slash command available in the current mode.
@@ -494,8 +503,11 @@ What is in it today:
   worktree, a stripped environment, a restricted tool roster, the same budget
   ledger and depth caps, and the same completion. `keryx agents external list`
   shows the registry; `keryx agents external run <id> --task "…"` or
-  `/delegate <agent> <task>` starts a run. It takes an explicit opt-in in your
-  own user config, and is hard disabled on a remote transport and under CI.
+  `/delegate <agent> <task>` starts a run; `claude`, `codex` and `agy` are
+  accepted as short names. `keryx agents external enable` (in the shell:
+  `/external-agents on`) is the one-step opt-in: your user config and this
+  project's manifest, nothing else. It is hard disabled on a remote transport
+  and under CI.
   keryx never reads a vendor credential store — not even to check whether you
   are logged in — so it reports *"installed … login not verified — keryx
   cannot know"* rather than a tick. **No vendor sanction is claimed.**
@@ -733,13 +745,16 @@ enabled. Nine modules are on after `init`; `mcp` is opt-in.
 
 | Runtime | Integration |
 |---------|-------------|
-| Claude Code | `CLAUDE.md` routing, orientation hook, security hooks, MCP server |
-| Codex | `AGENTS.md` routing and orientation hook |
+| Claude Code | `CLAUDE.local.md` routing, orientation hook, security hooks, MCP server |
+| Codex | `AGENTS.override.md` routing and orientation hook |
 | Cursor | Rules/orientation, security hooks, MCP server |
 | Any other agent | Repository-local Markdown/JSON artifacts under `.metaproject/` |
 
-After `init`, agents follow the root `AGENTS.md`/`CLAUDE.md` pointer to
-`.metaproject/index.md`, which routes them to the right capability. Two commands
+After `init`, agents follow the routing block — in `CLAUDE.local.md` and
+`AGENTS.override.md` by default, in the shared `CLAUDE.md`/`AGENTS.md` under
+`scope: "shared"` — to `.metaproject/index.md`, which routes them to the right
+capability. Those local files exist per checkout: run `keryx update` in a new
+worktree to give it the block and hooks. Two commands
 sharpen that routing:
 
 `keryx orient` emits a bounded excerpt of the launch project's own
@@ -927,7 +942,7 @@ flags too much for your rule set; lower it only if you have evidence the
 agent is actually acting on the extra flags.
 
 ```bash
-keryx review jev-edit-guard install   # merge-safe: writes .claude/settings.json
+keryx review jev-edit-guard install   # merge-safe: writes .claude/settings.local.json
 ```
 
 Then opt in per project — the hook is installed but stays silent until this is set: