@jaggerxtrm/specialists 2.1.13 → 2.1.14

package/README.md

@@ -195,13 +195,18 @@ Pre-script output is formatted as `<pre_flight_context>` XML and available in `t
 
 ## CLI
 
-Once installed globally, the `specialists` command provides:
+Once installed globally, `specialists <command>` provides:
 
 | Command | Description |
 |---------|-------------|
-| `specialists install` | Full-stack installer: pi, beads, dolt, MCP registration, hooks, scaffold |
-| `specialists list` | List all discovered specialists with model, description, and scope |
-| `specialists version` | Print the installed package version |
+| `specialists install` | Full-stack installer: pi, beads, dolt, MCP registration, hooks |
+| `specialists init` | Scaffold `./specialists/` and inject usage block into `AGENTS.md` |
+| `specialists list` | List discovered specialists with model, description, and scope |
+| `specialists edit <name> --<field> <value>` | Edit a specialist field in-place |
+| `specialists run <name>` | Run a specialist and stream output to stdout |
+| `specialists status` | Show system health: specialists, pi, beads, MCP |
+| `specialists version` | Print installed package version |
+| `specialists help` | Show command reference |
 | `specialists` | Start the MCP server (called by Claude Code — not for direct use) |
 
 ### specialists list
@@ -218,6 +223,59 @@ Specialists (9)
 
 Scopes: `[project]` = `./specialists/` (or `.claude/specialists/`), `[user]` = `~/.agents/specialists/`
 
+Filter by scope or category: `specialists list --scope user --category analysis`
+
+### specialists edit
+
+Edit individual fields without opening the file:
+
+```bash
+specialists edit init-session --model anthropic/claude-sonnet-4-6
+specialists edit bug-hunt --permission MEDIUM
+specialists edit overthinker --timeout 300000
+specialists edit codebase-explorer --tags "analysis,architecture"
+specialists edit my-spec --description "New description" --dry-run
+```
+
+Editable fields: `model`, `fallback-model`, `description`, `permission`, `timeout`, `tags`
+
+### specialists run
+
+Run a specialist directly from the terminal — no MCP required:
+
+```bash
+# Inline prompt
+specialists run init-session --prompt "What changed recently?"
+
+# Pipe from stdin
+echo "Analyse the architecture" | specialists run codebase-explorer
+
+# Override model, skip beads
+specialists run overthinker --prompt "Refactor strategy?" --model anthropic/claude-sonnet-4-6 --no-beads
+```
+
+Output streams to stdout in real time. Model, duration, and bead ID appear on stderr.
+
+### specialists status
+
+```
+specialists status
+
+── Specialists ───────────────────────────
+  ✓ 9 found  (9 project)
+
+── pi  (coding agent runtime) ────────────
+  ✓ v0.57.1  —  4 providers active  (anthropic, google-gemini-cli, qwen, zai)
+
+── beads  (issue tracker) ────────────────
+  ✓ bd installed  v0.59.0
+  ✓ .beads/ present in project
+
+── MCP ───────────────────────────────────
+  ✓ specialists binary installed  /usr/local/bin/specialists
+  verify registration: claude mcp get specialists
+```
+
 ---
 
 ## Development

package/bin/install.js

@@ -303,14 +303,14 @@ process.exit(0);
 
 const BEADS_EDIT_GATE_ENTRY = {
   matcher: 'Edit|Write|MultiEdit|NotebookEdit|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol',
-  hooks: [{ type: 'command', command: BEADS_EDIT_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_EDIT_GATE_FILE, timeout: 10000 }],
 };
 const BEADS_COMMIT_GATE_ENTRY = {
   matcher: 'Bash',
-  hooks: [{ type: 'command', command: BEADS_COMMIT_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_COMMIT_GATE_FILE, timeout: 10000 }],
 };
 const BEADS_STOP_GATE_ENTRY = {
-  hooks: [{ type: 'command', command: BEADS_STOP_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_STOP_GATE_FILE, timeout: 10000 }],
 };
 
 function installHook() {

package/dist/index.js

@@ -18149,7 +18149,7 @@ import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname as dirname2, join as join4 } from "node:path";
 async function run() {
-  const installerPath = join4(dirname2(fileURLToPath(import.meta.url)), "..", "..", "bin", "install.js");
+  const installerPath = join4(dirname2(fileURLToPath(import.meta.url)), "..", "bin", "install.js");
   execFileSync(process.execPath, [installerPath], { stdio: "inherit" });
 }
 var init_install = () => {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaggerxtrm/specialists",
-  "version": "2.1.13",
+  "version": "2.1.14",
   "description": "OmniSpecialist — 7-tool MCP orchestration layer powered by the Specialist System. Discover and execute .specialist.yaml files across project/user/system scopes via pi.",
   "main": "dist/index.js",
   "type": "module",