@spatz/cli 0.1.2 → 0.1.4

package/README.md

@@ -19,7 +19,7 @@ You or your coding agent run the task with the recommended pair.
 Different tasks need different models and effort levels.
 spatz combines task classification with results from your previous tasks.
 
-- **Use your available models.** Pass the candidates with `--models`.
+- **Use your available models.** Start with harness defaults or set your own candidates.
 - **Learn from results.** Record outcomes through hooks or `spatz report`.
 - **Compare performance.** Use `spatz stats` to see results per task type or routing scope.
 - **Connect to coding agents.** Hooks support Claude Code and Codex CLI. Other agents can use the CLI directly.
@@ -45,15 +45,15 @@ For the unstable nightly version, use `npm install -g @spatz/cli@nightly`.
 
 ### 2. Ask for a recommendation
 
-Pass the task and the model pairs that your agent can run:
+From Claude Code or Codex, pass the task:
 
 ```bash
-spatz "Fix the off-by-one error in src/list.ts" \
-  --models claude-opus-5-5:high+medium,claude-sonnet-5-5:medium+low
+spatz "Fix the off-by-one error in src/list.ts"
 ```
 
-Each candidate uses `<model-id>:<effort>+<effort>...`.
-Use model IDs and efforts that your environment supports.
+spatz uses a preset for the detected harness.
+Override it with `--models`, `SPATZ_MODELS`, or `models` in [configuration files](docs/configuration.md#default-models).
+Use `--family claude` or `--family gpt` to filter candidates for a review.
 The output includes a `suggestion_id` and a ranked list of pairs.
 Add `--json` for machine-readable output.
 
@@ -115,7 +115,7 @@ Hooks and the mod can run together. The mod's `record: auto` avoids duplicate us
 ### Install for Claude Code
 
 Use macOS or Linux with a POSIX shell. The plugins do not support native Windows.
-Install the [spatz CLI](#quickstart) first so the hooks and mod can find it on `PATH`.
+The plugins run the CLI through a bundled launcher: an installed `spatz` on `PATH` wins, otherwise it uses Bun or npx from the `PATH` Claude Code starts with.
 The mod needs Claude Code 2.1.287 or newer.
 
 1. Start Claude Code. Add the marketplace and install the hooks:
@@ -179,8 +179,8 @@ Keep the suggestion output unfiltered so the hooks can read its ID.
 After the task, ask the agent to report the actual pair and result with `spatz report`.
 Run `spatz stats` to see recorded outcomes.
 
-Every plugin ships the `spatz` routing skill. You do not need to edit your agent instructions.
-The hooks plugins can also run without a global CLI through their bundled launcher using Bun or npx.
+Every plugin ships the `routing` skill (`/spatz:routing`, `/spatz-mod:routing`, or `spatz:routing` in Codex). The mod's `/spatz` command checks status and changes mode or scope. You do not need to edit your agent instructions.
+Every plugin can run without a global CLI through its bundled launcher using Bun or npx.
 The first run downloads about 60 MB. Codex hooks time out after 10 seconds.
 For this setup, warm the launcher before the first session with `"<plugin root>/bin/spatz" --version`.
 See [Installation](docs/installation.md) for launcher paths and setup without a global CLI.

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@spatz/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Model and effort recommendations for coding agents",
   "bin": {
     "spatz": "bin/spatz.js"
   },
   "optionalDependencies": {
-    "@spatz/cli-linux-x64": "0.1.2",
-    "@spatz/cli-linux-arm64": "0.1.2",
-    "@spatz/cli-darwin-arm64": "0.1.2",
-    "@spatz/cli-darwin-x64": "0.1.2",
-    "@spatz/cli-win32-x64": "0.1.2"
+    "@spatz/cli-linux-x64": "0.1.4",
+    "@spatz/cli-linux-arm64": "0.1.4",
+    "@spatz/cli-darwin-arm64": "0.1.4",
+    "@spatz/cli-darwin-x64": "0.1.4",
+    "@spatz/cli-win32-x64": "0.1.4"
   },
   "engines": {
     "node": ">=18"