orchestrix 16.0.0 → 16.0.2

package/README.md

@@ -0,0 +1,81 @@
+# orchestrix
+
+Install [Orchestrix](https://orchestrix-mcp.youlidao.ai) multi-agent infrastructure into any project.
+
+## Quick Start
+
+```bash
+npx orchestrix install
+```
+
+That's it. You'll be prompted for your license key, then all files are installed.
+
+## What Gets Installed
+
+| File | Purpose |
+|------|---------|
+| `.claude/commands/o.md` | `/o dev`, `/o sm` — activate agents |
+| `.claude/commands/o-help.md` | `/o-help` — list available agents |
+| `.claude/commands/o-status.md` | `/o-status` — check server status |
+| `.mcp.json` | MCP Server configuration (merged with existing) |
+| `.orchestrix-core/core-config.yaml` | Project configuration |
+| `.orchestrix-core/scripts/start-orchestrix.sh` | tmux multi-agent session launcher |
+| `.orchestrix-core/scripts/handoff-detector.sh` | Auto HANDOFF routing between agents |
+| `.claude/settings.local.json` | Claude Code Stop hook for HANDOFF detection |
+| `.env.local` | License key storage (gitignored) |
+
+## Commands
+
+```bash
+npx orchestrix install [options]    # Install into current project
+npx orchestrix doctor               # Check installation health
+npx orchestrix upgrade              # Upgrade to latest version
+npx orchestrix uninstall            # Remove Orchestrix files
+```
+
+### Install Options
+
+| Flag | Description |
+|------|-------------|
+| `--key <KEY>` | License key (skips interactive prompt) |
+| `--offline` | Use embedded files only (no network) |
+| `--force` | Overwrite all files without confirmation |
+| `--no-hooks` | Skip Stop hook installation |
+| `--no-scripts` | Skip tmux scripts installation |
+| `--no-mcp` | Skip .mcp.json modification |
+
+## Usage After Install
+
+Open the project in Claude Code and use:
+
+```
+/o dev          # Activate Developer agent
+/o sm           # Activate Scrum Master agent
+/o qa           # Activate QA Engineer agent
+/o architect    # Activate Solution Architect agent
+/o-help         # Show all available agents
+```
+
+### tmux Multi-Agent Automation
+
+Launch 4 agents (Architect, SM, Dev, QA) in parallel tmux windows with automatic HANDOFF routing:
+
+```bash
+bash .orchestrix-core/scripts/start-orchestrix.sh
+```
+
+## How It Works
+
+- **Smart merge**: `.mcp.json` and `settings.local.json` are deep-merged — your existing entries are preserved.
+- **Idempotent**: Safe to run multiple times. Won't duplicate hooks or overwrite customized `core-config.yaml`.
+- **Offline ready**: Use `--offline` to install from bundled files without network access.
+- **Zero dependencies**: Pure Node.js built-ins only.
+
+## Related
+
+- [Orchestrix MCP Server](https://github.com/dorayo/orchestrix-mcp-server) — Central agent configuration server
+- [orchestrix-yuri](https://www.npmjs.com/package/orchestrix-yuri) — Meta-orchestrator for project lifecycle management
+
+## License
+
+MIT

package/bin/o8x.js

@@ -58,15 +58,15 @@ async function main() {
 function printHelp() {
   const { version } = require('../package.json');
   console.log(`
-  o8x v${version} — Install Orchestrix multi-agent infrastructure
+  orchestrix v${version} — Install Orchestrix multi-agent infrastructure
 
   Usage:
-    npx o8x install [options]       Install into current project
-    npx o8x doctor                  Check installation health
-    npx o8x upgrade                 Upgrade to latest from MCP server
-    npx o8x uninstall               Remove Orchestrix files from project
-    npx o8x --version               Show version
-    npx o8x --help                  Show this help message
+    npx orchestrix install [options]       Install into current project
+    npx orchestrix doctor                  Check installation health
+    npx orchestrix upgrade                 Upgrade to latest from MCP server
+    npx orchestrix uninstall               Remove Orchestrix files from project
+    npx orchestrix --version               Show version
+    npx orchestrix --help                  Show this help message
 
   Install options:
     --key <KEY>          License key (skips interactive prompt)
@@ -78,10 +78,10 @@ function printHelp() {
     -y, --yes            Skip confirmations
 
   Examples:
-    npx o8x install                           Interactive install
-    npx o8x install --key orch_live_xxx       Install with key
-    npx o8x install --offline                 Offline install (embedded files)
-    npx o8x doctor                            Health check
+    npx orchestrix install                           Interactive install
+    npx orchestrix install --key orch_live_xxx       Install with key
+    npx orchestrix install --offline                 Offline install (embedded files)
+    npx orchestrix doctor                            Health check
   `);
 }
 

package/lib/doctor.js

@@ -142,7 +142,7 @@ async function doctor(flags) {
   if (allGood) {
     ui.success('All checks passed');
   } else {
-    ui.info('Some checks failed — run "npx o8x install" to fix');
+    ui.info('Some checks failed — run "npx orchestrix install" to fix');
   }
   console.log();
 }

package/lib/ui.js

@@ -82,7 +82,7 @@ async function confirm(question, defaultYes = false) {
 
 function banner() {
   console.log();
-  console.log(`  ${colors.magenta}${colors.bold}o8x${colors.reset} ${colors.dim}— Orchestrix Installer${colors.reset}`);
+  console.log(`  ${colors.magenta}${colors.bold}orchestrix${colors.reset} ${colors.dim}— Orchestrix Installer${colors.reset}`);
   console.log();
 }
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "orchestrix",
-  "version": "16.0.0",
-  "description": "Install Orchestrix multi-agent infrastructure into any project. One command: npx o8x install",
+  "version": "16.0.2",
+  "description": "Install Orchestrix multi-agent infrastructure into any project. One command: npx orchestrix install",
   "bin": {
-    "o8x": "bin/o8x.js"
+    "orchestrix": "bin/o8x.js"
   },
   "files": [
     "bin/",
@@ -24,6 +24,14 @@
   ],
   "author": "dorayo",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dorayo/orchestrix.git"
+  },
+  "homepage": "https://github.com/dorayo/orchestrix#readme",
+  "bugs": {
+    "url": "https://github.com/dorayo/orchestrix/issues"
+  },
   "engines": {
     "node": ">=18.0.0"
   },