okstra 0.4.0 → 0.5.0

package/bin/okstra

@@ -7,27 +7,42 @@ const COMMANDS = new Map([
   ["ensure-installed", () => import("../src/install.mjs").then((m) => m.runEnsureInstalled)],
   ["uninstall", () => import("../src/uninstall.mjs").then((m) => m.runUninstall)],
   ["doctor", () => import("../src/doctor.mjs").then((m) => m.run)],
+  ["setup", () => import("../src/setup.mjs").then((m) => m.run)],
   ["check-project", () => import("../src/check-project.mjs").then((m) => m.run)],
 ]);
 
-const USAGE = `okstra — runtime installer + path/setup resolver for okstra skills
+const USAGE = `okstra — multi-agent cross-verification orchestrator for Claude Code
+
+This CLI is the installer/admin tool. Day-to-day usage happens inside a
+Claude Code session via slash commands (/okstra-setup, /okstra-run, ...).
+
+Quick start (CLI):
+  1. npx -y okstra@latest install                       # one-time, this machine
+  2. cd <your project>
+  3. npx -y okstra@latest setup --project-id <id>       # one-time, this project
+  4. open a Claude Code session and run /okstra-run     # start a task
+
+Inside a Claude Code session you can replace step 3 with /okstra-setup —
+both write the same <PROJECT_ROOT>/.project-docs/okstra/project.json.
 
 Usage:
   okstra <command> [options]
 
-Commands:
-  install                Install okstra runtime + skills into ~/.okstra + ~/.claude/skills
+Admin commands:
+  install                Install runtime to ~/.okstra and skills to ~/.claude/skills
   ensure-installed       Verify install is fresh; reinstall if stale (idempotent)
-  uninstall              Remove installed runtime + skills (user data preserved by default)
-  paths                  Print runtime paths (workspace/agents/pythonpath/bin/home/version)
+  uninstall              Remove runtime + skills (user data preserved by default)
+  setup                  Register the current project (.project-docs/okstra/project.json)
   doctor                 Diagnostic check of the installed runtime
-  check-project          Verify current project has .project-docs/okstra/project.json
+  check-project          Verify the current project has been registered with setup
+  paths                  Print runtime paths (workspace/agents/pythonpath/bin/home/version)
 
 Global options:
   --version              Print okstra version and exit
   --help                 Print this help
 
 Run 'okstra <command> --help' for command-specific options.
+Docs: https://github.com/Devonshin/okstra#readme
 `;
 
 async function main(argv) {