Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

fix(scaffold): add dead-reference guard + deterministic CLI remap (ADR-382 Part C) (#2974)

rUv83e536396f68
diff --git a/.github/workflows/v3-ci.yml b/.github/workflows/v3-ci.yml
index dd7c58b240..d456dec47f 100644
--- a/.github/workflows/v3-ci.yml
+++ b/.github/workflows/v3-ci.yml
@@ -123,6 +123,11 @@ on:
- 'plugins/*/skills/**'
- 'plugins/*/commands/**'
- 'scripts/smoke-init-bundle-invariants.mjs'
+ # Init-scaffold content-drift guard (ADR-382 Part C, #2971) β€” dead
+ # CLI/tool refs, plugin MCP-launch pinning, marketplace completeness.
+ - 'plugins/*/.mcp.json'
+ - '.claude-plugin/marketplace.json'
+ - 'scripts/smoke-init-scaffold-references.mjs'
# ADR-129 β€” rvagent full integration (P1-P4)
- 'v3/@claude-flow/cli/src/ruvector/agent-wasm.ts'
- 'v3/@claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts'
@@ -241,6 +246,11 @@ on:
- 'plugins/*/skills/**'
- 'plugins/*/commands/**'
- 'scripts/smoke-init-bundle-invariants.mjs'
+ # Init-scaffold content-drift guard (ADR-382 Part C, #2971) β€” dead
+ # CLI/tool refs, plugin MCP-launch pinning, marketplace completeness.
+ - 'plugins/*/.mcp.json'
+ - '.claude-plugin/marketplace.json'
+ - 'scripts/smoke-init-scaffold-references.mjs'
# ADR-129 β€” rvagent full integration (P1-P4)
- 'v3/@claude-flow/cli/src/ruvector/agent-wasm.ts'
- 'v3/@claude-flow/cli/src/mcp-tools/wasm-agent-tools.ts'
@@ -2235,6 +2245,39 @@ jobs:
- name: Run init-bundle invariants smoke
run: node scripts/smoke-init-bundle-invariants.mjs
+ init-scaffold-references-smoke:
+ # Regression guard for ruvnet/ruflo#2971 β€” ADR-382 Part C.
+ #
+ # Statically scans the @claude-flow/cli init scaffold and the
+ # plugin/marketplace surface for four content-drift classes:
+ #
+ # 1. Dead `npx claude-flow` (bare) CLI invocations.
+ # 2. Dead `mcp__claude-flow__<tool>` references not in the live
+ # tool registry (derived from mcp-client.ts's own imports).
+ # 3. Plugin .mcp.json launches that regress to a bare unpinned
+ # `@latest` npx call with no local-bin-first resolver.
+ # 4. plugins/* directories missing from .claude-plugin/marketplace.json.
+ #
+ # Ships warn-only (no --strict) until the deterministic remap (ADR-382
+ # Part C step 2) clears the dead-reference backlog and ADR-382 Part A
+ # lands the .mcp.json resolver + marketplace entries.
+ #
+ # Zero runtime deps; pure Node.js readFileSync + readdirSync.
+ name: init-scaffold references smoke (#2971, ADR-382 Part C)
+ runs-on: ubuntu-latest
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: '22'
+
+ - name: Run init-scaffold references smoke
+ run: node scripts/smoke-init-scaffold-references.mjs
+
wasm-provider-bridge-smoke:
# ADR-129 Phase 1 β€” JsModelProvider routes WasmAgent through the v3
# provider system. Pre-P1: set_model_provider() was never called and
diff --git a/scripts/smoke-init-scaffold-references.mjs b/scripts/smoke-init-scaffold-references.mjs
new file mode 100644
index 0000000000..b1e7369573
--- /dev/null
+++ b/scripts/smoke-init-scaffold-references.mjs
@@ -0,0 +1,359 @@
+#!/usr/bin/env node
+/**
+ * Init-scaffold content-drift guard β€” ADR-382 Part C (#2971).
+ *
+ * Four static assertions over the shipped @claude-flow/cli init scaffold and
+ * the marketplace/plugin surface it depends on:
+ *
+ * 1. DEAD CLI INVOCATION β€” `npx claude-flow` (bare, unscoped, unpinned) in
+ * v3/@claude-flow/cli/.claude/**. The canonical form is derived from
+ * that package's own package.json `name`, not hand-maintained, so this
+ * check tracks a future rename automatically. `npx claude-flow@alpha` /
+ * `@v3alpha` are intentionally NOT flagged β€” those are the maintained
+ * legacy dist-tags (see root CLAUDE.md Publishing section), not dead.
+ *
+ * 2. DEAD MCP TOOL REFERENCES β€” `mcp__claude-flow__<name>` (or the
+ * `mcp__claude_flow__` underscore typo) where <name> is not present in
+ * the live tool registry. The live set is derived by statically
+ * parsing mcp-client.ts's own import list and extracting every
+ * `name: '...'` tool declaration from each imported module β€” the same
+ * registry the running MCP server assembles at startup (mcp-client.ts
+ * TOOL_REGISTRY), just read without executing TypeScript. Wildcard doc
+ * references like `mcp__claude-flow__swarm_*` are not flagged.
+ *
+ * 3. PLUGIN MCP-LAUNCH PINNING REGRESSION β€” any plugins/*\/.mcp.json whose
+ * server launches a bare `npx ... <pkg>@latest` with no local-bin-first
+ * resolver in front of it (ADR-382 Part A fixes this for ruflo-core by
+ * mirroring resolveCliBinForHook() in .claude/helpers/hook-handler.cjs;
+ * this check guards the fix from regressing and catches any other
+ * plugin with the same unpinned pattern).
+ *
+ * 4. MARKETPLACE COMPLETENESS β€” every directory under plugins/ has a
+ * matching entry in .claude-plugin/marketplace.json. Guards the
+ * regression that let ruflo-agntcy / ruflo-bbs-federation /
+ * ruflo-business-pods silently go unlisted (ADR-382 Gap 4).
+ *
+ * Ships in WARN-ONLY mode: violations are always printed, but the process
+ * exits 0 unless `--strict` is passed, in which case it exits 1 on any
+ * violation. Run `--strict` once the deterministic remap (ADR-382 Part C
+ * step 2) has driven checks 1-2's backlog to zero; checks 3-4 can go
+ * `--strict` as soon as Part A lands.
+ *
+ * Zero runtime dependencies beyond Node built-ins β€” pure readFileSync /
+ * readdirSync / regex, following the smoke-deprecated-actions.mjs /
+ * smoke-init-bundle-invariants.mjs pattern.
+ *
+ * Usage:
+ * node scripts/smoke-init-scaffold-references.mjs # warn-only, always exit 0
+ * node scripts/smoke-init-scaffold-references.mjs --strict # exit 1 on any violation
+ * node scripts/smoke-init-scaffold-references.mjs --help # this text
+ */
+
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const REPO_ROOT = process.cwd();
+const STRICT = process.argv.includes('--strict');
+const HELP = process.argv.includes('--help') || process.argv.includes('-h');
+
+const USAGE = `smoke-init-scaffold-references.mjs β€” ADR-382 Part C dead-reference guard
+
+Checks the @claude-flow/cli init scaffold (v3/@claude-flow/cli/.claude/**)
+and the plugin/marketplace surface for stale CLI invocations, dead MCP tool
+references, unpinned plugin MCP launches, and marketplace registry gaps.
+
+Modes:
+ (default) warn-only β€” prints every violation, always exits 0
+ --strict blocking β€” prints every violation, exits 1 if any are found
+
+This ships warn-only in the PR that introduces it (ADR-382 Part C), because
+the dead-reference backlog (checks 1-2) is nonzero until the deterministic
+remap lands. Flip CI to --strict once that backlog clears; checks 3-4 can go
+--strict independently once ADR-382 Part A merges.
+
+Flags:
+ --strict exit 1 on any violation (see above)
+ --help,-h print this message and exit 0
+`;
+
+if (HELP) {
+ console.log(USAGE);
+ process.exit(0);
+}
+
+const CLI_ROOT = join(REPO_ROOT, 'v3', '@claude-flow', 'cli');
+const CLI_SRC = join(CLI_ROOT, 'src');
+const MCP_CLIENT_TS = join(CLI_SRC, 'mcp-client.ts');
+const SCAFFOLD_DIR = join(CLI_ROOT, '.claude');
+const PLUGINS_DIR = join(REPO_ROOT, 'plugins');
+const MARKETPLACE_JSON = join(REPO_ROOT, '.claude-plugin', 'marketplace.json');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function walkFiles(dir) {
+ if (!existsSync(dir)) return [];
+ const out = [];
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
+ const full = join(dir, entry.name);
+ if (entry.isDirectory()) {
+ out.push(...walkFiles(full));
+ } else if (entry.isFile()) {
+ out.push(full);
+ }
+ }
+ return out;
+}
+
+function rel(p) {
+ return p.startsWith(REPO_ROOT + '/') ? p.slice(REPO_ROOT.length + 1) : p;
+}
+
+function readText(p) {
+ try {
+ return readFileSync(p, 'utf-8');
+ } catch {
+ return null;
+ }
+}
+
+// ---------------------------------------------------------------------------
+// Live-registry derivation (checks 1-2)
+// ---------------------------------------------------------------------------
+
+// Statically parses mcp-client.ts's own `from './mcp-tools/foo.js'` imports
+// and extracts every `name: '...'` MCPTool declaration from each resolved
+// .ts source β€” the exact set TOOL_REGISTRY assembles at runtime, derived
+// without executing TypeScript.
+function deriveLiveToolNames() {
+ const names = new Set();
+ const src = readText(MCP_CLIENT_TS);
+ if (!src) return names;
+
+ const modules = new Set();
+ for (const m of src.matchAll(/from\s+'(\.\/[^']+)\.js'/g)) {
+ modules.add(m[1].replace(/^\.\//, ''));
+ }
+
+ for (const mod of modules) {
+ const modSrc = readText(join(CLI_SRC, `${mod}.ts`));
+ if (!modSrc) continue;
+ for (const m of modSrc.matchAll(/^\s*name:\s*'([a-zA-Z0-9_-]+)'/gm)) {
+ names.add(m[1]);
+ }
+ }
+ return names;
+}
+
+// Derives the canonical `npx <pkg>@latest` form from the CLI package's own
+// package.json `name` field rather than hand-maintaining the string, so a
+// future rename doesn't silently desync the guard from reality.
+function deriveCanonicalCliInvocation() {
+ const pkgSrc = readText(join(CLI_ROOT, 'package.json'));
+ if (!pkgSrc) return 'npx @claude-flow/cli@latest';
+ try {
+ const pkg = JSON.parse(pkgSrc);
+ return `npx ${pkg.name}@latest`;
+ } catch {
+ return 'npx @claude-flow/cli@latest';
+ }
+}
+
+const LIVE_TOOL_NAMES = deriveLiveToolNames();
+const CANONICAL_CLI_INVOCATION = deriveCanonicalCliInvocation();
+
+// ---------------------------------------------------------------------------
+// Check 1 β€” dead `npx claude-flow` (bare) invocation
+// ---------------------------------------------------------------------------
+
+// Negative lookahead excludes `@version` (maintained legacy dist-tags),
+// word chars, `/` and `-` so we never match inside `@claude-flow/cli` or a
+// hypothetical `claude-flow-codex` β€” only the bare, unscoped, unpinned form.
+const DEAD_CLI_PATTERN = /npx claude-flow(?![\w@/-])/g;
+
+function checkDeadCliInvocations(files) {
+ const violations = [];
+ for (const file of files) {
+ const content = readText(file);
+ if (!content) continue;
+ const lines = content.split('\n');
+ for (let i = 0; i < lines.length; i++) {
+ if (DEAD_CLI_PATTERN.test(lines[i])) {
+ violations.push({
+ file: rel(file),
+ line: i + 1,
+ text: lines[i].trim(),
+ message: `'npx claude-flow' (bare) β€” supersede with '${CANONICAL_CLI_INVOCATION}'`,
+ });
+ }
+ DEAD_CLI_PATTERN.lastIndex = 0;
+ }
+ }
+ return violations;
+}
+
+// ---------------------------------------------------------------------------
+// Check 2 β€” dead `mcp__claude-flow__<tool>` references
+// ---------------------------------------------------------------------------
+
+const TOOL_REF_PATTERN = /mcp__claude[-_]flow__([A-Za-z][A-Za-z0-9_-]*)/g;
+
+function checkDeadToolReferences(files) {
+ const violations = [];
+ for (const file of files) {
+ const content = readText(file);
+ if (!content) continue;
+ const lines = content.split('\n');
+ for (let i = 0; i < lines.length; i++) {
+ const line = lines[i];
+ for (const m of line.matchAll(TOOL_REF_PATTERN)) {
+ const name = m[1];
+ const endIdx = m.index + m[0].length;
+ if (line[endIdx] === '*') continue; // wildcard family doc, e.g. swarm_*
+ if (LIVE_TOOL_NAMES.has(name)) continue;
+ violations.push({
+ file: rel(file),
+ line: i + 1,
+ text: line.trim(),
+ message: `mcp__claude-flow__${name} β€” not in the live ${LIVE_TOOL_NAMES.size}-tool registry`,
+ });
+ }
+ }
+ }
+ return violations;
+}
+
+// ---------------------------------------------------------------------------
+// Check 3 β€” plugin MCP-launch pinning regression
+// ---------------------------------------------------------------------------
+
+// Matches an npx arg that is a bare `@latest`-tagged launch of one of the
+// three public release-train packages (root CLAUDE.md), with no local-bin
+// resolver indirection in front of it.
+const UNPINNED_LATEST_ARG = /^(?:@claude-flow\/cli|claude-flow|ruflo)@latest$/;
+
+function findPluginMcpJsonFiles() {
+ if (!existsSync(PLUGINS_DIR)) return [];
+ const out = [];
+ for (const entry of readdirSync(PLUGINS_DIR, { withFileTypes: true })) {
+ if (!entry.isDirectory()) continue;
+ const p = join(PLUGINS_DIR, entry.name, '.mcp.json');
+ if (existsSync(p)) out.push(p);
+ }
+ return out;
+}
+
+function checkPluginMcpPinning() {
+ const violations = [];
+ for (const file of findPluginMcpJsonFiles()) {
+ const src = readText(file);
+ if (!src) continue;
+ let json;
+ try {
+ json = JSON.parse(src);
+ } catch (e) {
+ violations.push({ file: rel(file), message: `invalid JSON: ${e.message}` });
+ continue;
+ }
+ const servers = json.mcpServers || {};
+ for (const [serverName, cfg] of Object.entries(servers)) {
+ const args = Array.isArray(cfg.args) ? cfg.args : [];
+ const bareLatestArg = args.find((a) => typeof a === 'string' && UNPINNED_LATEST_ARG.test(a));
+ if (cfg.command === 'npx' && bareLatestArg) {
+ violations.push({
+ file: rel(file),
+ message: `server '${serverName}' launches bare 'npx -y ${bareLatestArg}' β€” no local-bin-first ` +
+ `resolver in front of it (mirror resolveCliBinForHook() in .claude/helpers/hook-handler.cjs, ADR-382 Part A)`,
+ });
+ }
+ }
+ }
+ return violations;
+}
+
+// ---------------------------------------------------------------------------
+// Check 4 β€” marketplace completeness
+// ---------------------------------------------------------------------------
+
+function checkMarketplaceCompleteness() {
+ const violations = [];
+ if (!existsSync(PLUGINS_DIR) || !existsSync(MARKETPLACE_JSON)) return violations;
+
+ const pluginDirs = readdirSync(PLUGINS_DIR, { withFileTypes: true })
+ .filter((e) => e.isDirectory())
+ .map((e) => e.name);
+
+ const marketplaceSrc = readText(MARKETPLACE_JSON);
+ let marketplace;
+ try {
+ marketplace = JSON.parse(marketplaceSrc);
+ } catch (e) {
+ violations.push({ file: rel(MARKETPLACE_JSON), message: `invalid JSON: ${e.message}` });
+ return violations;
+ }
+
+ const registered = new Set(
+ (marketplace.plugins || [])
+ .map((p) => (typeof p.source === 'string' ? p.source.replace(/^\.\/plugins\//, '').replace(/\/$/, '') : null))
+ .filter(Boolean)
+ );
+
+ for (const dir of pluginDirs) {
+ if (!registered.has(dir)) {
+ violations.push({
+ file: `plugins/${dir}`,
+ message: `directory has no entry in .claude-plugin/marketplace.json (plugin uninstallable via marketplace)`,
+ });
+ }
+ }
+ return violations;
+}
+
+// ---------------------------------------------------------------------------
+// Run all checks
+// ---------------------------------------------------------------------------
+
+const scaffoldFiles = walkFiles(SCAFFOLD_DIR);
+
+const results = [
+ { id: 1, name: 'dead CLI invocation (npx claude-flow bare)', violations: checkDeadCliInvocations(scaffoldFiles) },
+ { id: 2, name: 'dead MCP tool references (mcp__claude-flow__*)', violations: checkDeadToolReferences(scaffoldFiles) },
+ { id: 3, name: 'plugin MCP-launch pinning regression', violations: checkPluginMcpPinning() },
+ { id: 4, name: 'marketplace completeness', violations: checkMarketplaceCompleteness() },
+];
+
+const totalViolations = results.reduce((sum, r) => sum + r.violations.length, 0);
+
+console.log(`init-scaffold-references: scanned ${scaffoldFiles.length} scaffold files, ` +
+ `${LIVE_TOOL_NAMES.size} live MCP tools derived, canonical CLI form '${CANONICAL_CLI_INVOCATION}'`);
+console.log(STRICT ? 'mode: --strict (blocking)' : 'mode: warn-only (pass --strict to block on violations)');
+console.log();
+
+for (const { id, name, violations } of results) {
+ if (violations.length === 0) {
+ console.log(`ok: check ${id} (${name}) β€” 0 violations`);
+ continue;
+ }
+ console.log(`FAIL: check ${id} (${name}) β€” ${violations.length} violation(s)`);
+ for (const v of violations) {
+ if (v.line) {
+ console.log(` ${v.file}:${v.line} ${v.text}`);
+ console.log(` ${v.message}`);
+ } else {
+ console.log(` ${v.file}`);
+ console.log(` ${v.message}`);
+ }
+ }
+}
+
+console.log();
+console.log(`total: ${totalViolations} violation(s) across 4 checks`);
+console.log('ADR-382: https://github.com/ruvnet/ruflo/blob/main/v3/docs/adr/ADR-382-init-scaffold-content-drift-remediation.md');
+console.log('Issue: https://github.com/ruvnet/ruflo/issues/2971');
+
+if (totalViolations > 0 && !STRICT) {
+ console.log('\nwarn-only mode: exiting 0 despite violations above. Pass --strict to make this blocking.');
+}
+
+process.exit(totalViolations > 0 && STRICT ? 1 : 0);
diff --git a/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md b/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md
index d8bd93617f..ac8c90c680 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/code-review-swarm.md
@@ -75,7 +75,7 @@ hooks:
# 4. Train neural patterns for high-quality reviews
if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
echo "🧠 Training neural pattern from successful code review"
- npx claude-flow neural train \
+ npx @claude-flow/cli@latest neural train \
--pattern-type "coordination" \
--training-data "$REVIEW_OUTPUT" \
--epochs 50
diff --git a/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md b/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md
index 10168208b6..0885870262 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/issue-tracker.md
@@ -79,7 +79,7 @@ hooks:
# 4. Train neural patterns for successful issue management
if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
echo "🧠 Training neural pattern from successful issue management"
- npx claude-flow neural train \
+ npx @claude-flow/cli@latest neural train \
--pattern-type "coordination" \
--training-data "$ISSUE_OUTPUT" \
--epochs 50
diff --git a/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md b/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md
index 65dadbca2a..b43c12a623 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/pr-manager.md
@@ -83,7 +83,7 @@ hooks:
# 4. Train neural patterns for successful PRs (optional)
if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
echo "🧠 Training neural pattern from successful PR management"
- npx claude-flow neural train \
+ npx @claude-flow/cli@latest neural train \
--pattern-type "coordination" \
--training-data "$PR_OUTPUT" \
--epochs 50
diff --git a/v3/@claude-flow/cli/.claude/agents/github/release-manager.md b/v3/@claude-flow/cli/.claude/agents/github/release-manager.md
index be50d51077..af4c1725f5 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/release-manager.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/release-manager.md
@@ -72,7 +72,7 @@ hooks:
# 3. Train neural patterns for successful releases
if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
echo "🧠 Training neural pattern from successful release"
- npx claude-flow neural train \
+ npx @claude-flow/cli@latest neural train \
--pattern-type "coordination" \
--training-data "$RELEASE_OUTPUT" \
--epochs 50
@@ -587,7 +587,7 @@ jobs:
cd claude-code-flow/claude-code-flow && npm install && npm test
cd ../../ruv-swarm/npm && npm install && npm test:all
- name: Validate Release
- run: npx claude-flow release validate
+ run: npx @claude-flow/cli@latest release validate
```
## Monitoring and Metrics
diff --git a/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md b/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md
index 32e6619bc1..0501e3907a 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/repo-architect.md
@@ -144,9 +144,9 @@ mcp__github__push_files {
## Quick Start
\`\`\`bash
-npx claude-flow init --sparc
+npx @claude-flow/cli@latest init --sparc
npm install
-npx claude-flow start --ui
+npx @claude-flow/cli@latest start --ui
\`\`\`
## Features
diff --git a/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md b/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md
index 3091519265..34230f8048 100644
--- a/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md
+++ b/v3/@claude-flow/cli/.claude/agents/github/workflow-automation.md
@@ -83,7 +83,7 @@ hooks:
# 4. Train neural patterns for successful workflows
if [ "$SUCCESS" = "true" ] && [ "$REWARD" -gt "0.9" ]; then
echo "🧠 Training neural pattern from successful workflow"
- npx claude-flow neural train \
+ npx @claude-flow/cli@latest neural train \
--pattern-type "coordination" \
--training-data "$WORKFLOW_OUTPUT" \
--epochs 50
diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md b/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md
index ea7dd580dd..bcf6dedd70 100644
--- a/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md
+++ b/v3/@claude-flow/cli/.claude/agents/optimization/benchmark-suite.md
@@ -577,31 +577,31 @@ const benchmarkIntegration = {
### Benchmarking Commands
```bash
# Run comprehensive benchmark suite
-npx claude-flow benchmark-run --suite comprehensive --duration 300
+npx @claude-flow/cli@latest benchmark-run --suite comprehensive --duration 300
# Execute specific benchmark
-npx claude-flow benchmark-run --suite throughput --iterations 10
+npx @claude-flow/cli@latest benchmark-run --suite throughput --iterations 10
# Compare with baseline
-npx claude-flow benchmark-compare --current <results> --baseline <baseline>
+npx @claude-flow/cli@latest benchmark-compare --current <results> --baseline <baseline>
# Quality assessment
-npx claude-flow quality-assess --target swarm-performance --criteria throughput,latency
+npx @claude-flow/cli@latest quality-assess --target swarm-performance --criteria throughput,latency
# Performance validation
-npx claude-flow validate-performance --results <file> --criteria <file>
+npx @claude-flow/cli@latest validate-performance --results <file> --criteria <file>
```
### Regression Detection Commands
```bash
# Detect performance regressions
-npx claude-flow detect-regression --current <results> --historical <data>
+npx @claude-flow/cli@latest detect-regression --current <results> --historical <data>
# Set up automated regression monitoring
-npx claude-flow regression-monitor --enable --sensitivity 0.95
+npx @claude-flow/cli@latest regression-monitor --enable --sensitivity 0.95
# Analyze error patterns
-npx claude-flow error-analysis --logs <log-files>
+npx @claude-flow/cli@latest error-analysis --logs <log-files>
```
## Integration Points
diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md b/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md
index 3d293384d9..ab95c77842 100644
--- a/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md
+++ b/v3/@claude-flow/cli/.claude/agents/optimization/load-balancer.md
@@ -353,28 +353,28 @@ class CircuitBreaker {
### Load Balancing Commands
```bash
# Initialize load balancer
-npx claude-flow agent spawn load-balancer --type coordinator
+npx @claude-flow/cli@latest agent spawn load-balancer --type coordinator
# Start load balancing
-npx claude-flow load-balance --swarm-id <id> --strategy adaptive
+npx @claude-flow/cli@latest load-balance --swarm-id <id> --strategy adaptive
# Monitor load distribution
-npx claude-flow agent-metrics --type load-balancer
+npx @claude-flow/cli@latest agent-metrics --type load-balancer
# Adjust balancing parameters
-npx claude-flow config-manage --action update --config '{"stealThreshold": 5, "agingBoost": 10}'
+npx @claude-flow/cli@latest config-manage --action update --config '{"stealThreshold": 5, "agingBoost": 10}'
```
### Performance Monitoring
```bash
# Real-time load monitoring
-npx claude-flow performance-report --format detailed
+npx @claude-flow/cli@latest performance-report --format detailed
# Bottleneck analysis
-npx claude-flow bottleneck-analyze --component swarm-coordination
+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination
# Resource utilization tracking
-npx claude-flow metrics-collect --components ["load-balancer", "task-queue"]
+npx @claude-flow/cli@latest metrics-collect --components ["load-balancer", "task-queue"]
```
## Integration Points
diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md b/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md
index 0c4d233d3b..89ef394ec5 100644
--- a/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md
+++ b/v3/@claude-flow/cli/.claude/agents/optimization/performance-monitor.md
@@ -582,31 +582,31 @@ class DashboardProvider {
### Monitoring Commands
```bash
# Start comprehensive monitoring
-npx claude-flow performance-report --format detailed --timeframe 24h
+npx @claude-flow/cli@latest performance-report --format detailed --timeframe 24h
# Real-time bottleneck analysis
-npx claude-flow bottleneck-analyze --component swarm-coordination
+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination
# Health check all components
-npx claude-flow health-check --components ["swarm", "agents", "coordination"]
+npx @claude-flow/cli@latest health-check --components ["swarm", "agents", "coordination"]
# Collect specific metrics
-npx claude-flow metrics-collect --components ["cpu", "memory", "network"]
+npx @claude-flow/cli@latest metrics-collect --components ["cpu", "memory", "network"]
# Monitor SLA compliance
-npx claude-flow sla-monitor --service swarm-coordination --threshold 99.9
+npx @claude-flow/cli@latest sla-monitor --service swarm-coordination --threshold 99.9
```
### Alert Configuration
```bash
# Configure performance alerts
-npx claude-flow alert-config --metric cpu_usage --threshold 80 --severity warning
+npx @claude-flow/cli@latest alert-config --metric cpu_usage --threshold 80 --severity warning
# Set up anomaly detection
-npx claude-flow anomaly-setup --models ["statistical", "ml", "time_series"]
+npx @claude-flow/cli@latest anomaly-setup --models ["statistical", "ml", "time_series"]
# Configure notification channels
-npx claude-flow notification-config --channels ["slack", "email", "webhook"]
+npx @claude-flow/cli@latest notification-config --channels ["slack", "email", "webhook"]
```
## Integration Points
diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md b/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md
index 5a5b5c688b..e56abfdf01 100644
--- a/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md
+++ b/v3/@claude-flow/cli/.claude/agents/optimization/resource-allocator.md
@@ -600,34 +600,34 @@ const resourceIntegration = {
### Resource Management Commands
```bash
# Analyze resource usage
-npx claude-flow metrics-collect --components ["cpu", "memory", "network"]
+npx @claude-flow/cli@latest metrics-collect --components ["cpu", "memory", "network"]
# Optimize resource allocation
-npx claude-flow daa-resource-alloc --resources <resource-config>
+npx @claude-flow/cli@latest daa-resource-alloc --resources <resource-config>
# Predictive scaling
-npx claude-flow swarm-scale --swarm-id <id> --target-size <size>
+npx @claude-flow/cli@latest swarm-scale --swarm-id <id> --target-size <size>
# Performance profiling
-npx claude-flow performance-report --format detailed --timeframe 24h
+npx @claude-flow/cli@latest performance-report --format detailed --timeframe 24h
# Circuit breaker configuration
-npx claude-flow fault-tolerance --strategy circuit-breaker --config <config>
+npx @claude-flow/cli@latest fault-tolerance --strategy circuit-breaker --config <config>
```
### Optimization Commands
```bash
# Run performance optimization
-npx claude-flow optimize-performance --swarm-id <id> --strategy adaptive
+npx @claude-flow/cli@latest optimize-performance --swarm-id <id> --strategy adaptive
# Generate resource forecasts
-npx claude-flow forecast-resources --time-horizon 3600 --confidence 0.95
+npx @claude-flow/cli@latest forecast-resources --time-horizon 3600 --confidence 0.95
# Profile system performance
-npx claude-flow profile-performance --duration 60000 --components all
+npx @claude-flow/cli@latest profile-performance --duration 60000 --components all
# Analyze bottlenecks
-npx claude-flow bottleneck-analyze --component swarm-coordination
+npx @claude-flow/cli@latest bottleneck-analyze --component swarm-coordination
```
## Integration Points
diff --git a/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md b/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md
index 39721989b1..1fecb66aa9 100644
--- a/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md
+++ b/v3/@claude-flow/cli/.claude/agents/optimization/topology-optimizer.md
@@ -726,31 +726,31 @@ class SimulatedAnnealingOptimizer {
### Topology Optimization Commands
```bash
# Analyze current topology
-npx claude-flow topology-analyze --swarm-id <id> --metrics performance
+npx @claude-flow/cli@latest topology-analyze --swarm-id <id> --metrics performance
# Optimize topology automatically
-npx claude-flow topology-optimize --swarm-id <id> --strategy adaptive
+npx @claude-flow/cli@latest topology-optimize --swarm-id <id> --strategy adaptive
# Compare topology configurations
-npx claude-flow topology-compare --topologies ["hierarchical", "mesh", "hybrid"]
+npx @claude-flow/cli@latest topology-compare --topologies ["hierarchical", "mesh", "hybrid"]
# Generate topology recommendations
-npx claude-flow topology-recommend --workload-profile <file> --constraints <file>
+npx @claude-flow/cli@latest topology-recommend --workload-profile <file> --constraints <file>
# Monitor topology performance
-npx claude-flow topology-monitor --swarm-id <id> --interval 60
+npx @claude-flow/cli@latest topology-monitor --swarm-id <id> --interval 60
```
### Agent Placement Commands
```bash
# Optimize agent placement
-npx claude-flow placement-optimize --algorithm genetic --agents <agent-list>
+npx @claude-flow/cli@latest placement-optimize --algorithm genetic --agents <agent-list>
# Analyze placement efficiency
-npx claude-flow placement-analyze --current-placement <config>
+npx @claude-flow/cli@latest placement-analyze --current-placement <config>
# Generate placement recommendations
-npx claude-flow placement-recommend --communication-patterns <file>
+npx @claude-flow/cli@latest placement-recommend --communication-patterns <file>
```
## Integration Points
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/README.md b/v3/@claude-flow/cli/.claude/commands/agents/README.md
index cf86089b5f..65352e61b6 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/README.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/README.md
@@ -28,16 +28,16 @@ Complete agent management commands for Claude Flow V3.
```bash
# Spawn a coder agent
-npx claude-flow agent spawn -t coder --name my-coder
+npx @claude-flow/cli@latest agent spawn -t coder --name my-coder
# List all active agents
-npx claude-flow agent list
+npx @claude-flow/cli@latest agent list
# Check agent health
-npx claude-flow agent health
+npx @claude-flow/cli@latest agent health
# View metrics
-npx claude-flow agent metrics --period 24h
+npx @claude-flow/cli@latest agent metrics --period 24h
```
## V3 Agent Categories
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md
index e8bb3eed7b..b857d9c035 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-capabilities.md
@@ -105,7 +105,7 @@ release-manager: mcp__github__*, mcp__claude-flow__workflow_*
```bash
# List all capabilities for an agent type
-npx claude-flow agent spawn -t coder --help
+npx @claude-flow/cli@latest agent spawn -t coder --help
# View agent definition
cat .claude/agents/core/coder.md
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md
index 704a6dc1e5..28dafb9ad4 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-coordination.md
@@ -7,19 +7,19 @@ Coordination patterns for multi-agent collaboration.
### Hierarchical
Queen-led with worker specialization
```bash
-npx claude-flow swarm init --topology hierarchical
+npx @claude-flow/cli@latest swarm init --topology hierarchical
```
### Mesh
Peer-to-peer collaboration
```bash
-npx claude-flow swarm init --topology mesh
+npx @claude-flow/cli@latest swarm init --topology mesh
```
### Adaptive
Dynamic topology based on workload
```bash
-npx claude-flow swarm init --topology adaptive
+npx @claude-flow/cli@latest swarm init --topology adaptive
```
## Best Practices
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md b/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md
index 83c04307b7..27d1bf4e00 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/agent-types.md
@@ -203,10 +203,10 @@ Complete guide to all 87 available agent types in Claude Flow V3.
```bash
# List all agent types
-npx claude-flow agent spawn --help
+npx @claude-flow/cli@latest agent spawn --help
# Spawn any agent
-npx claude-flow agent spawn -t <agent-type>
+npx @claude-flow/cli@latest agent spawn -t <agent-type>
```
## See Also
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/health.md b/v3/@claude-flow/cli/.claude/commands/agents/health.md
index 1794668d7f..9a1bc021e5 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/health.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/health.md
@@ -11,7 +11,7 @@ Monitor agent health status, resource usage, and detect issues.
## Usage
```bash
-npx claude-flow agent health [agent-id] [options]
+npx @claude-flow/cli@latest agent health [agent-id] [options]
```
## Options
@@ -26,19 +26,19 @@ npx claude-flow agent health [agent-id] [options]
```bash
# Overall health check
-npx claude-flow agent health
+npx @claude-flow/cli@latest agent health
# Specific agent health
-npx claude-flow agent health coder-lx7m9k2
+npx @claude-flow/cli@latest agent health coder-lx7m9k2
# Continuous monitoring
-npx claude-flow agent health --watch
+npx @claude-flow/cli@latest agent health --watch
# Custom interval
-npx claude-flow agent health -w -i 10
+npx @claude-flow/cli@latest agent health -w -i 10
# JSON output
-npx claude-flow agent health --format json
+npx @claude-flow/cli@latest agent health --format json
```
## Output
@@ -99,7 +99,7 @@ Recommendations
Continuous monitoring with real-time updates:
```bash
-npx claude-flow agent health --watch
+npx @claude-flow/cli@latest agent health --watch
# Output updates every 5 seconds:
# [10:30:15] Agent Health: 3 healthy, 0 warning, 0 critical
@@ -134,6 +134,6 @@ Press `Ctrl+C` to stop watching.
## Related Commands
-- `npx claude-flow agent status` - Detailed agent info
-- `npx claude-flow agent metrics` - Performance metrics
-- `npx claude-flow doctor` - System-wide health
+- `npx @claude-flow/cli@latest agent status` - Detailed agent info
+- `npx @claude-flow/cli@latest agent metrics` - Performance metrics
+- `npx @claude-flow/cli@latest doctor` - System-wide health
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/list.md b/v3/@claude-flow/cli/.claude/commands/agents/list.md
index 1ed7c0b20c..3bc507ce9e 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/list.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/list.md
@@ -12,8 +12,8 @@ List all active agents in the Claude Flow system with filtering options.
## Usage
```bash
-npx claude-flow agent list [options]
-npx claude-flow agent ls [options] # Alias
+npx @claude-flow/cli@latest agent list [options]
+npx @claude-flow/cli@latest agent ls [options] # Alias
```
## Options
@@ -29,22 +29,22 @@ npx claude-flow agent ls [options] # Alias
```bash
# List all active agents
-npx claude-flow agent list
+npx @claude-flow/cli@latest agent list
# List all agents including inactive
-npx claude-flow agent list --all
+npx @claude-flow/cli@latest agent list --all
# Filter by type
-npx claude-flow agent list -t coder
+npx @claude-flow/cli@latest agent list -t coder
# Filter by status
-npx claude-flow agent list -s idle
+npx @claude-flow/cli@latest agent list -s idle
# JSON output for scripting
-npx claude-flow agent list --format json
+npx @claude-flow/cli@latest agent list --format json
# Combined filters
-npx claude-flow agent list -t researcher -s active
+npx @claude-flow/cli@latest agent list -t researcher -s active
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/logs.md b/v3/@claude-flow/cli/.claude/commands/agents/logs.md
index e0a90b2819..6fb0274098 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/logs.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/logs.md
@@ -11,7 +11,7 @@ View activity logs and history for agents.
## Usage
```bash
-npx claude-flow agent logs <agent-id> [options]
+npx @claude-flow/cli@latest agent logs <agent-id> [options]
```
## Options
@@ -28,23 +28,23 @@ npx claude-flow agent logs <agent-id> [options]
```bash
# View last 50 lines
-npx claude-flow agent logs coder-lx7m9k2
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2
# View last 100 lines
-npx claude-flow agent logs coder-lx7m9k2 -n 100
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 -n 100
# Follow logs (live)
-npx claude-flow agent logs coder-lx7m9k2 --follow
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --follow
# Filter by level
-npx claude-flow agent logs coder-lx7m9k2 -l error
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 -l error
# Logs since time
-npx claude-flow agent logs coder-lx7m9k2 --since "1h"
-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "1h"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "2026-01-08T10:00:00"
# JSON output
-npx claude-flow agent logs coder-lx7m9k2 --format json
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --format json
```
## Output
@@ -77,7 +77,7 @@ Logs for coder-lx7m9k2
Real-time log streaming:
```bash
-npx claude-flow agent logs coder-lx7m9k2 --follow
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --follow
# New logs appear as they occur:
# 2026-01-08 10:40:15 [INFO] Task received: refactor-auth
@@ -91,16 +91,16 @@ Press `Ctrl+C` to stop following.
```bash
# Last hour
-npx claude-flow agent logs coder-lx7m9k2 --since "1h"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "1h"
# Last 30 minutes
-npx claude-flow agent logs coder-lx7m9k2 --since "30m"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "30m"
# Specific timestamp
-npx claude-flow agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "2026-01-08T09:00:00"
# Today's logs
-npx claude-flow agent logs coder-lx7m9k2 --since "today"
+npx @claude-flow/cli@latest agent logs coder-lx7m9k2 --since "today"
```
## JSON Output
@@ -125,6 +125,6 @@ npx claude-flow agent logs coder-lx7m9k2 --since "today"
## Related Commands
-- `npx claude-flow agent status` - Current agent status
-- `npx claude-flow agent health` - Health monitoring
-- `npx claude-flow agent metrics` - Performance metrics
+- `npx @claude-flow/cli@latest agent status` - Current agent status
+- `npx @claude-flow/cli@latest agent health` - Health monitoring
+- `npx @claude-flow/cli@latest agent metrics` - Performance metrics
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/metrics.md b/v3/@claude-flow/cli/.claude/commands/agents/metrics.md
index b923c07694..c761cd789a 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/metrics.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/metrics.md
@@ -11,7 +11,7 @@ Display comprehensive performance metrics for agents including V3 performance ga
## Usage
```bash
-npx claude-flow agent metrics [agent-id] [options]
+npx @claude-flow/cli@latest agent metrics [agent-id] [options]
```
## Options
@@ -25,19 +25,19 @@ npx claude-flow agent metrics [agent-id] [options]
```bash
# Overall metrics for last 24 hours
-npx claude-flow agent metrics
+npx @claude-flow/cli@latest agent metrics
# Metrics for specific agent
-npx claude-flow agent metrics coder-lx7m9k2
+npx @claude-flow/cli@latest agent metrics coder-lx7m9k2
# Last hour
-npx claude-flow agent metrics -p 1h
+npx @claude-flow/cli@latest agent metrics -p 1h
# Last 7 days
-npx claude-flow agent metrics --period 7d
+npx @claude-flow/cli@latest agent metrics --period 7d
# JSON output
-npx claude-flow agent metrics --format json
+npx @claude-flow/cli@latest agent metrics --format json
```
## Output
@@ -117,6 +117,6 @@ V3 Performance Gains
## Related Commands
-- `npx claude-flow agent status` - Individual agent metrics
-- `npx claude-flow performance benchmark` - Full performance suite
-- `npx claude-flow status` - System-wide status
+- `npx @claude-flow/cli@latest agent status` - Individual agent metrics
+- `npx @claude-flow/cli@latest performance benchmark` - Full performance suite
+- `npx @claude-flow/cli@latest status` - System-wide status
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/pool.md b/v3/@claude-flow/cli/.claude/commands/agents/pool.md
index 75ff21fbb1..9494759a9d 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/pool.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/pool.md
@@ -11,7 +11,7 @@ Manage the agent pool for automatic scaling and resource optimization.
## Usage
```bash
-npx claude-flow agent pool [options]
+npx @claude-flow/cli@latest agent pool [options]
```
## Options
@@ -28,19 +28,19 @@ npx claude-flow agent pool [options]
```bash
# View current pool status
-npx claude-flow agent pool
+npx @claude-flow/cli@latest agent pool
# Set pool size
-npx claude-flow agent pool --size 5
+npx @claude-flow/cli@latest agent pool --size 5
# Configure auto-scaling
-npx claude-flow agent pool --min 2 --max 15 --auto-scale
+npx @claude-flow/cli@latest agent pool --min 2 --max 15 --auto-scale
# Pre-warm agents for fast response
-npx claude-flow agent pool --warmup
+npx @claude-flow/cli@latest agent pool --warmup
# Disable auto-scaling
-npx claude-flow agent pool --auto-scale false
+npx @claude-flow/cli@latest agent pool --auto-scale false
```
## Output
@@ -89,7 +89,7 @@ Auto-Scale Rules
Pre-warm agents to reduce cold-start latency:
```bash
-npx claude-flow agent pool --warmup
+npx @claude-flow/cli@latest agent pool --warmup
# Pre-warms default agent types:
# - coder (2 instances)
@@ -122,6 +122,6 @@ agent:
## Related Commands
-- `npx claude-flow agent spawn` - Manual agent spawning
-- `npx claude-flow agent list` - View active agents
-- `npx claude-flow swarm scale` - Swarm-level scaling
+- `npx @claude-flow/cli@latest agent spawn` - Manual agent spawning
+- `npx @claude-flow/cli@latest agent list` - View active agents
+- `npx @claude-flow/cli@latest swarm scale` - Swarm-level scaling
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/spawn.md b/v3/@claude-flow/cli/.claude/commands/agents/spawn.md
index 30b87d2cd9..361256549d 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/spawn.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/spawn.md
@@ -11,7 +11,7 @@ Spawn a new agent with full V3 capabilities including neural patterns, memory in
## Usage
```bash
-npx claude-flow agent spawn [options]
+npx @claude-flow/cli@latest agent spawn [options]
```
## Options
@@ -30,74 +30,74 @@ npx claude-flow agent spawn [options]
### Core Development
```bash
-npx claude-flow agent spawn -t coder # Code implementation
-npx claude-flow agent spawn -t reviewer # Code review
-npx claude-flow agent spawn -t tester # Testing
-npx claude-flow agent spawn -t planner # Planning
-npx claude-flow agent spawn -t researcher # Research
+npx @claude-flow/cli@latest agent spawn -t coder # Code implementation
+npx @claude-flow/cli@latest agent spawn -t reviewer # Code review
+npx @claude-flow/cli@latest agent spawn -t tester # Testing
+npx @claude-flow/cli@latest agent spawn -t planner # Planning
+npx @claude-flow/cli@latest agent spawn -t researcher # Research
```
### V3 Specialized
```bash
-npx claude-flow agent spawn -t security-architect # Security design
-npx claude-flow agent spawn -t security-auditor # CVE remediation
-npx claude-flow agent spawn -t memory-specialist # AgentDB (150x-12,500x faster)
-npx claude-flow agent spawn -t performance-engineer # 2.49x-7.47x optimization
-npx claude-flow agent spawn -t core-architect # DDD design
+npx @claude-flow/cli@latest agent spawn -t security-architect # Security design
+npx @claude-flow/cli@latest agent spawn -t security-auditor # CVE remediation
+npx @claude-flow/cli@latest agent spawn -t memory-specialist # AgentDB (150x-12,500x faster)
+npx @claude-flow/cli@latest agent spawn -t performance-engineer # 2.49x-7.47x optimization
+npx @claude-flow/cli@latest agent spawn -t core-architect # DDD design
```
### Swarm Coordination
```bash
-npx claude-flow agent spawn -t hierarchical-coordinator # Queen-led
-npx claude-flow agent spawn -t mesh-coordinator # P2P network
-npx claude-flow agent spawn -t adaptive-coordinator # Dynamic topology
-npx claude-flow agent spawn -t collective-intelligence-coordinator
+npx @claude-flow/cli@latest agent spawn -t hierarchical-coordinator # Queen-led
+npx @claude-flow/cli@latest agent spawn -t mesh-coordinator # P2P network
+npx @claude-flow/cli@latest agent spawn -t adaptive-coordinator # Dynamic topology
+npx @claude-flow/cli@latest agent spawn -t collective-intelligence-coordinator
```
### Consensus Agents
```bash
-npx claude-flow agent spawn -t byzantine-coordinator # BFT consensus
-npx claude-flow agent spawn -t raft-manager # Leader-based
-npx claude-flow agent spawn -t gossip-coordinator # Eventual consistency
-npx claude-flow agent spawn -t crdt-synchronizer # CRDT replication
-npx claude-flow agent spawn -t quorum-manager # Quorum-based
+npx @claude-flow/cli@latest agent spawn -t byzantine-coordinator # BFT consensus
+npx @claude-flow/cli@latest agent spawn -t raft-manager # Leader-based
+npx @claude-flow/cli@latest agent spawn -t gossip-coordinator # Eventual consistency
+npx @claude-flow/cli@latest agent spawn -t crdt-synchronizer # CRDT replication
+npx @claude-flow/cli@latest agent spawn -t quorum-manager # Quorum-based
```
### GitHub Integration
```bash
-npx claude-flow agent spawn -t pr-manager # PR lifecycle
-npx claude-flow agent spawn -t code-review-swarm # Multi-agent review
-npx claude-flow agent spawn -t issue-tracker # Issue management
-npx claude-flow agent spawn -t release-manager # Release coordination
-npx claude-flow agent spawn -t workflow-automation # CI/CD automation
+npx @claude-flow/cli@latest agent spawn -t pr-manager # PR lifecycle
+npx @claude-flow/cli@latest agent spawn -t code-review-swarm # Multi-agent review
+npx @claude-flow/cli@latest agent spawn -t issue-tracker # Issue management
+npx @claude-flow/cli@latest agent spawn -t release-manager # Release coordination
+npx @claude-flow/cli@latest agent spawn -t workflow-automation # CI/CD automation
```
### SPARC Methodology
```bash
-npx claude-flow agent spawn -t sparc-coordinator # SPARC orchestration
-npx claude-flow agent spawn -t specification # Requirements
-npx claude-flow agent spawn -t pseudocode # Algorithm design
-npx claude-flow agent spawn -t architecture # System design
-npx claude-flow agent spawn -t refinement # Iterative improvement
+npx @claude-flow/cli@latest agent spawn -t sparc-coordinator # SPARC orchestration
+npx @claude-flow/cli@latest agent spawn -t specification # Requirements
+npx @claude-flow/cli@latest agent spawn -t pseudocode # Algorithm design
+npx @claude-flow/cli@latest agent spawn -t architecture # System design
+npx @claude-flow/cli@latest agent spawn -t refinement # Iterative improvement
```
## Examples
```bash
# Spawn with custom name
-npx claude-flow agent spawn -t coder --name feature-bot
+npx @claude-flow/cli@latest agent spawn -t coder --name feature-bot
# Spawn with initial task
-npx claude-flow agent spawn -t researcher --task "Research React 19 features"
+npx @claude-flow/cli@latest agent spawn -t researcher --task "Research React 19 features"
# Spawn with specific model
-npx claude-flow agent spawn -t architect -m claude-3-opus-20240229
+npx @claude-flow/cli@latest agent spawn -t architect -m claude-3-opus-20240229
# Spawn with custom timeout
-npx claude-flow agent spawn -t tester --timeout 600
+npx @claude-flow/cli@latest agent spawn -t tester --timeout 600
# Spawn using OpenRouter
-npx claude-flow agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
+npx @claude-flow/cli@latest agent spawn -t coder -p openrouter -m anthropic/claude-3.5-sonnet
```
## Using Claude Code's Task Tool
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/status.md b/v3/@claude-flow/cli/.claude/commands/agents/status.md
index fc4804c29e..7ab66db6c7 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/status.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/status.md
@@ -11,8 +11,8 @@ Display comprehensive status information for a specific agent including metrics,
## Usage
```bash
-npx claude-flow agent status <agent-id>
-npx claude-flow agent status --id <agent-id>
+npx @claude-flow/cli@latest agent status <agent-id>
+npx @claude-flow/cli@latest agent status --id <agent-id>
```
## Options
@@ -26,13 +26,13 @@ npx claude-flow agent status --id <agent-id>
```bash
# Get status by ID
-npx claude-flow agent status coder-lx7m9k2
+npx @claude-flow/cli@latest agent status coder-lx7m9k2
# Using --id flag
-npx claude-flow agent status --id researcher-abc123
+npx @claude-flow/cli@latest agent status --id researcher-abc123
# JSON output
-npx claude-flow agent status coder-lx7m9k2 --format json
+npx @claude-flow/cli@latest agent status coder-lx7m9k2 --format json
```
## Output
@@ -109,7 +109,7 @@ The status command provides:
## Related Commands
-- `npx claude-flow agent list` - Find agent IDs
-- `npx claude-flow agent metrics` - Aggregate metrics
-- `npx claude-flow agent health` - Health check
-- `npx claude-flow agent logs <id>` - Activity logs
+- `npx @claude-flow/cli@latest agent list` - Find agent IDs
+- `npx @claude-flow/cli@latest agent metrics` - Aggregate metrics
+- `npx @claude-flow/cli@latest agent health` - Health check
+- `npx @claude-flow/cli@latest agent logs <id>` - Activity logs
diff --git a/v3/@claude-flow/cli/.claude/commands/agents/stop.md b/v3/@claude-flow/cli/.claude/commands/agents/stop.md
index a590840fc3..10c6157078 100644
--- a/v3/@claude-flow/cli/.claude/commands/agents/stop.md
+++ b/v3/@claude-flow/cli/.claude/commands/agents/stop.md
@@ -12,8 +12,8 @@ Stop a running agent with graceful or forced shutdown options.
## Usage
```bash
-npx claude-flow agent stop <agent-id> [options]
-npx claude-flow agent kill <agent-id> [options] # Alias
+npx @claude-flow/cli@latest agent stop <agent-id> [options]
+npx @claude-flow/cli@latest agent kill <agent-id> [options] # Alias
```
## Options
@@ -27,16 +27,16 @@ npx claude-flow agent kill <agent-id> [options] # Alias
```bash
# Graceful stop (completes current task)
-npx claude-flow agent stop coder-lx7m9k2
+npx @claude-flow/cli@latest agent stop coder-lx7m9k2
# Force stop (immediate termination)
-npx claude-flow agent stop coder-lx7m9k2 --force
+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force
# Custom shutdown timeout
-npx claude-flow agent stop coder-lx7m9k2 --timeout 60
+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --timeout 60
# Using kill alias
-npx claude-flow agent kill researcher-abc123 -f
+npx @claude-flow/cli@latest agent kill researcher-abc123 -f
```
## Graceful vs Force Stop
@@ -48,7 +48,7 @@ npx claude-flow agent kill researcher-abc123 -f
4. Notifies swarm coordinator
```bash
-npx claude-flow agent stop coder-lx7m9k2
+npx @claude-flow/cli@latest agent stop coder-lx7m9k2
# Output:
# Stopping agent coder-lx7m9k2...
@@ -64,7 +64,7 @@ npx claude-flow agent stop coder-lx7m9k2
3. May leave tasks incomplete
```bash
-npx claude-flow agent stop coder-lx7m9k2 --force
+npx @claude-flow/cli@latest agent stop coder-lx7m9k2 --force
# Output:
# Stopping agent coder-lx7m9k2...
@@ -85,18 +85,18 @@ To stop multiple agents:
```bash
# Stop all agents of a type
-npx claude-flow agent list -t coder --format json | \
+npx @claude-flow/cli@latest agent list -t coder --format json | \
jq -r '.agents[].id' | \
- xargs -I {} npx claude-flow agent stop {} -f
+ xargs -I {} npx @claude-flow/cli@latest agent stop {} -f
# Stop all idle agents
-npx claude-flow agent list -s idle --format json | \
+npx @claude-flow/cli@latest agent list -s idle --format json | \
jq -r '.agents[].id' | \
- xargs -I {} npx claude-flow agent stop {}
+ xargs -I {} npx @claude-flow/cli@latest agent stop {}
```
## Related Commands
-- `npx claude-flow agent list` - Find agent IDs
-- `npx claude-flow agent status` - Check status before stopping
-- `npx claude-flow swarm destroy` - Stop all agents in swarm
+- `npx @claude-flow/cli@latest agent list` - Find agent IDs
+- `npx @claude-flow/cli@latest agent status` - Check status before stopping
+- `npx @claude-flow/cli@latest swarm destroy` - Stop all agents in swarm
diff --git a/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md b/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md
index 79ab8bea35..b601da9ccd 100644
--- a/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md
+++ b/v3/@claude-flow/cli/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md
@@ -3,7 +3,7 @@
## Overview
Reviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:
- `mcp__claude-flow__*` tools (preferred)
-- `npx claude-flow` commands (as fallback)
+- `npx @claude-flow/cli@latest` commands (as fallback)
- No direct implementation calls
## Files Reviewed
diff --git a/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md b/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md
index 85c8595eb6..d584fcfc50 100644
--- a/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md
+++ b/v3/@claude-flow/cli/.claude/commands/analysis/bottleneck-detect.md
@@ -5,7 +5,7 @@ Analyze performance bottlenecks in swarm operations and suggest optimizations.
## Usage
```bash
-npx claude-flow bottleneck detect [options]
+npx @claude-flow/cli@latest bottleneck detect [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow bottleneck detect [options]
### Basic bottleneck detection
```bash
-npx claude-flow bottleneck detect
+npx @claude-flow/cli@latest bottleneck detect
```
### Analyze specific swarm
```bash
-npx claude-flow bottleneck detect --swarm-id swarm-123
+npx @claude-flow/cli@latest bottleneck detect --swarm-id swarm-123
```
### Last 24 hours with export
```bash
-npx claude-flow bottleneck detect -t 24h -e bottlenecks.json
+npx @claude-flow/cli@latest bottleneck detect -t 24h -e bottlenecks.json
```
### Auto-fix detected issues
```bash
-npx claude-flow bottleneck detect --fix --threshold 15
+npx @claude-flow/cli@latest bottleneck detect --fix --threshold 15
```
## Metrics Analyzed
diff --git a/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md b/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md
index 04b8d9e9ac..8a4a136922 100644
--- a/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md
+++ b/v3/@claude-flow/cli/.claude/commands/analysis/performance-report.md
@@ -4,7 +4,7 @@ Generate comprehensive performance reports for swarm operations.
## Usage
```bash
-npx claude-flow analysis performance-report [options]
+npx @claude-flow/cli@latest analysis performance-report [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow analysis performance-report [options]
## Examples
```bash
# Generate HTML report
-npx claude-flow analysis performance-report --format html
+npx @claude-flow/cli@latest analysis performance-report --format html
# Compare swarms
-npx claude-flow analysis performance-report --compare swarm-123
+npx @claude-flow/cli@latest analysis performance-report --compare swarm-123
# Full metrics report
-npx claude-flow analysis performance-report --include-metrics --format markdown
+npx @claude-flow/cli@latest analysis performance-report --include-metrics --format markdown
```
diff --git a/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md b/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md
index 5d6f2b9cff..a6a90d80b4 100644
--- a/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md
+++ b/v3/@claude-flow/cli/.claude/commands/analysis/token-usage.md
@@ -4,7 +4,7 @@ Analyze token usage patterns and optimize for efficiency.
## Usage
```bash
-npx claude-flow analysis token-usage [options]
+npx @claude-flow/cli@latest analysis token-usage [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow analysis token-usage [options]
## Examples
```bash
# Last 24 hours token usage
-npx claude-flow analysis token-usage --period 24h
+npx @claude-flow/cli@latest analysis token-usage --period 24h
# By agent breakdown
-npx claude-flow analysis token-usage --by-agent
+npx @claude-flow/cli@latest analysis token-usage --by-agent
# Export detailed report
-npx claude-flow analysis token-usage --period 7d --export tokens.csv
+npx @claude-flow/cli@latest analysis token-usage --period 7d --export tokens.csv
```
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md b/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md
index d064e6f4c5..2ed2ac4ee6 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/auto-agent.md
@@ -5,7 +5,7 @@ Automatically spawn and manage agents based on task requirements.
## Usage
```bash
-npx claude-flow auto agent [options]
+npx @claude-flow/cli@latest auto agent [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow auto agent [options]
### Basic auto-spawning
```bash
-npx claude-flow auto agent --task "Build a REST API with authentication"
+npx @claude-flow/cli@latest auto agent --task "Build a REST API with authentication"
```
### Constrained spawning
```bash
-npx claude-flow auto agent -t "Debug performance issue" --max-agents 3
+npx @claude-flow/cli@latest auto agent -t "Debug performance issue" --max-agents 3
```
### Analysis only
```bash
-npx claude-flow auto agent -t "Refactor codebase" --no-spawn
+npx @claude-flow/cli@latest auto agent -t "Refactor codebase" --no-spawn
```
### Minimal strategy
```bash
-npx claude-flow auto agent -t "Fix bug in login" -s minimal
+npx @claude-flow/cli@latest auto agent -t "Fix bug in login" -s minimal
```
## How It Works
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md b/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md
index db86b6dca9..aee0b95d55 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/self-healing.md
@@ -94,7 +94,7 @@ mcp__claude-flow__task_orchestrate({
{
"PostToolUse": [{
"matcher": "^Bash$",
- "command": "npx claude-flow hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"
+ "command": "npx @claude-flow/cli@latest hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"
}]
}
```
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md b/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md
index f556e7fec1..ad68611a39 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/session-memory.md
@@ -30,7 +30,7 @@ mcp__claude-flow__context_restore({
**Fallback with npx:**
```bash
-npx claude-flow hook session-restore --session-id "sess-123"
+npx @claude-flow/cli@latest hook session-restore --session-id "sess-123"
```
### 3. Memory Types
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md b/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md
index 8960ab201e..de3c67c53e 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/smart-agents.md
@@ -63,7 +63,7 @@ mcp__claude-flow__agent_spawn({
### Fallback Configuration
If MCP tools are unavailable:
```bash
-npx claude-flow hook pre-task --auto-spawn-agents
+npx @claude-flow/cli@latest hook pre-task --auto-spawn-agents
```
## Benefits
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md b/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md
index f78c2a9c19..efdb681a64 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/smart-spawn.md
@@ -4,7 +4,7 @@ Intelligently spawn agents based on workload analysis.
## Usage
```bash
-npx claude-flow automation smart-spawn [options]
+npx @claude-flow/cli@latest automation smart-spawn [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow automation smart-spawn [options]
## Examples
```bash
# Smart spawn with analysis
-npx claude-flow automation smart-spawn --analyze
+npx @claude-flow/cli@latest automation smart-spawn --analyze
# Set spawn threshold
-npx claude-flow automation smart-spawn --threshold 5
+npx @claude-flow/cli@latest automation smart-spawn --threshold 5
# Force topology
-npx claude-flow automation smart-spawn --topology hierarchical
+npx @claude-flow/cli@latest automation smart-spawn --topology hierarchical
```
diff --git a/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md b/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md
index 9ae59a70ef..2c3a6bda07 100644
--- a/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md
+++ b/v3/@claude-flow/cli/.claude/commands/automation/workflow-select.md
@@ -4,7 +4,7 @@ Automatically select optimal workflow based on task type.
## Usage
```bash
-npx claude-flow automation workflow-select [options]
+npx @claude-flow/cli@latest automation workflow-select [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow automation workflow-select [options]
## Examples
```bash
# Select workflow for task
-npx claude-flow automation workflow-select --task "Deploy to production"
+npx @claude-flow/cli@latest automation workflow-select --task "Deploy to production"
# With constraints
-npx claude-flow automation workflow-select --constraints "no-downtime,rollback"
+npx @claude-flow/cli@latest automation workflow-select --constraints "no-downtime,rollback"
# Preview mode
-npx claude-flow automation workflow-select --task "Database migration" --preview
+npx @claude-flow/cli@latest automation workflow-select --task "Database migration" --preview
```
diff --git a/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md b/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md
index 8f500b337b..8f81c6d2f6 100644
--- a/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md
+++ b/v3/@claude-flow/cli/.claude/commands/claude-flow-help.md
@@ -91,7 +91,7 @@ npx -y claude-flow@latest init --sparc
```
## 🎯 Best Practices
-- Use `./claude-flow` instead of `npx claude-flow` after initialization
+- Use `./claude-flow` instead of `npx @claude-flow/cli@latest` after initialization
- Store important context in memory for cross-session persistence
- Use swarm mode for complex tasks requiring multiple agents
- Enable monitoring for real-time progress tracking
diff --git a/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md b/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md
index d018805a4b..bd2d37f1a9 100644
--- a/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md
+++ b/v3/@claude-flow/cli/.claude/commands/coordination/agent-spawn.md
@@ -4,7 +4,7 @@ Spawn a new agent in the current swarm.
## Usage
```bash
-npx claude-flow agent spawn [options]
+npx @claude-flow/cli@latest agent spawn [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow agent spawn [options]
## Examples
```bash
# Spawn coder agent
-npx claude-flow agent spawn --type coder
+npx @claude-flow/cli@latest agent spawn --type coder
# With custom name
-npx claude-flow agent spawn --type researcher --name "API Expert"
+npx @claude-flow/cli@latest agent spawn --type researcher --name "API Expert"
# With specific skills
-npx claude-flow agent spawn --type coder --skills "python,fastapi,testing"
+npx @claude-flow/cli@latest agent spawn --type coder --skills "python,fastapi,testing"
```
diff --git a/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md b/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md
index d4019791e8..4b0068e45c 100644
--- a/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md
+++ b/v3/@claude-flow/cli/.claude/commands/coordination/swarm-init.md
@@ -5,7 +5,7 @@ Initialize a Claude Flow swarm with specified topology and configuration.
## Usage
```bash
-npx claude-flow swarm init [options]
+npx @claude-flow/cli@latest swarm init [options]
```
## Options
@@ -22,25 +22,25 @@ npx claude-flow swarm init [options]
### Basic initialization
```bash
-npx claude-flow swarm init
+npx @claude-flow/cli@latest swarm init
```
### Mesh topology for research
```bash
-npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
+npx @claude-flow/cli@latest swarm init --topology mesh --max-agents 5 --strategy balanced
```
### Hierarchical for development
```bash
-npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
```
### GitHub-focused swarm
```bash
-npx claude-flow swarm init --topology star --github --memory
+npx @claude-flow/cli@latest swarm init --topology star --github --memory
```
## Topologies
diff --git a/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md b/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md
index 3788b816aa..71673cfd0a 100644
--- a/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md
+++ b/v3/@claude-flow/cli/.claude/commands/coordination/task-orchestrate.md
@@ -4,7 +4,7 @@ Orchestrate complex tasks across the swarm.
## Usage
```bash
-npx claude-flow task orchestrate [options]
+npx @claude-flow/cli@latest task orchestrate [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow task orchestrate [options]
## Examples
```bash
# Orchestrate development task
-npx claude-flow task orchestrate --task "Implement user authentication"
+npx @claude-flow/cli@latest task orchestrate --task "Implement user authentication"
# High priority task
-npx claude-flow task orchestrate --task "Fix production bug" --priority critical
+npx @claude-flow/cli@latest task orchestrate --task "Fix production bug" --priority critical
# With specific strategy
-npx claude-flow task orchestrate --task "Refactor codebase" --strategy parallel
+npx @claude-flow/cli@latest task orchestrate --task "Refactor codebase" --strategy parallel
```
diff --git a/v3/@claude-flow/cli/.claude/commands/github/code-review.md b/v3/@claude-flow/cli/.claude/commands/github/code-review.md
index 58bede9e2f..68e72dfad2 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/code-review.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/code-review.md
@@ -4,7 +4,7 @@ Automated code review with swarm intelligence.
## Usage
```bash
-npx claude-flow github code-review [options]
+npx @claude-flow/cli@latest github code-review [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow github code-review [options]
## Examples
```bash
# Review PR
-npx claude-flow github code-review --pr-number 456
+npx @claude-flow/cli@latest github code-review --pr-number 456
# Security focus
-npx claude-flow github code-review --pr-number 456 --focus security
+npx @claude-flow/cli@latest github code-review --pr-number 456 --focus security
# With fix suggestions
-npx claude-flow github code-review --pr-number 456 --suggest-fixes
+npx @claude-flow/cli@latest github code-review --pr-number 456 --suggest-fixes
```
diff --git a/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md b/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md
index 776ee9a879..6d032b5598 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/github-swarm.md
@@ -5,7 +5,7 @@ Create a specialized swarm for GitHub repository management.
## Usage
```bash
-npx claude-flow github swarm [options]
+npx @claude-flow/cli@latest github swarm [options]
```
## Options
@@ -22,25 +22,25 @@ npx claude-flow github swarm [options]
### Basic GitHub swarm
```bash
-npx claude-flow github swarm --repository owner/repo
+npx @claude-flow/cli@latest github swarm --repository owner/repo
```
### Maintenance-focused swarm
```bash
-npx claude-flow github swarm -r owner/repo -f maintenance --issue-labels
+npx @claude-flow/cli@latest github swarm -r owner/repo -f maintenance --issue-labels
```
### Development swarm with PR automation
```bash
-npx claude-flow github swarm -r owner/repo -f development --auto-pr --code-review
+npx @claude-flow/cli@latest github swarm -r owner/repo -f development --auto-pr --code-review
```
### Full-featured triage swarm
```bash
-npx claude-flow github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr
+npx @claude-flow/cli@latest github swarm -r owner/repo -a 8 -f triage --issue-labels --auto-pr
```
## Agent Types
diff --git a/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md b/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md
index 5d98773f02..11dbf6e202 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/issue-triage.md
@@ -4,7 +4,7 @@ Intelligent issue classification and triage.
## Usage
```bash
-npx claude-flow github issue-triage [options]
+npx @claude-flow/cli@latest github issue-triage [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow github issue-triage [options]
## Examples
```bash
# Triage issues
-npx claude-flow github issue-triage --repository myorg/myrepo
+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo
# With auto-labeling
-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label
+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo --auto-label
# Full automation
-npx claude-flow github issue-triage --repository myorg/myrepo --auto-label --assign
+npx @claude-flow/cli@latest github issue-triage --repository myorg/myrepo --auto-label --assign
```
diff --git a/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md b/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md
index 3ceb3f3289..733b486d28 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/pr-enhance.md
@@ -4,7 +4,7 @@ AI-powered pull request enhancements.
## Usage
```bash
-npx claude-flow github pr-enhance [options]
+npx @claude-flow/cli@latest github pr-enhance [options]
```
## Options
@@ -16,11 +16,11 @@ npx claude-flow github pr-enhance [options]
## Examples
```bash
# Enhance PR
-npx claude-flow github pr-enhance --pr-number 123
+npx @claude-flow/cli@latest github pr-enhance --pr-number 123
# Add tests
-npx claude-flow github pr-enhance --pr-number 123 --add-tests
+npx @claude-flow/cli@latest github pr-enhance --pr-number 123 --add-tests
# Full enhancement
-npx claude-flow github pr-enhance --pr-number 123 --add-tests --improve-docs
+npx @claude-flow/cli@latest github pr-enhance --pr-number 123 --add-tests --improve-docs
```
diff --git a/v3/@claude-flow/cli/.claude/commands/github/release-manager.md b/v3/@claude-flow/cli/.claude/commands/github/release-manager.md
index 8038920b26..530fd91ac5 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/release-manager.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/release-manager.md
@@ -322,7 +322,7 @@ jobs:
cd claude-code-flow/claude-code-flow && npm install && npm test
cd ../../ruv-swarm/npm && npm install && npm test:all
- name: Validate Release
- run: npx claude-flow release validate
+ run: npx @claude-flow/cli@latest release validate
```
## Monitoring and Metrics
diff --git a/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md b/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md
index 167f5b47ab..bf1bcfce89 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/repo-analyze.md
@@ -4,7 +4,7 @@ Deep analysis of GitHub repository with AI insights.
## Usage
```bash
-npx claude-flow github repo-analyze [options]
+npx @claude-flow/cli@latest github repo-analyze [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow github repo-analyze [options]
## Examples
```bash
# Basic analysis
-npx claude-flow github repo-analyze --repository myorg/myrepo
+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo
# Deep analysis
-npx claude-flow github repo-analyze --repository myorg/myrepo --deep
+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo --deep
# Specific areas
-npx claude-flow github repo-analyze --repository myorg/myrepo --include issues,prs
+npx @claude-flow/cli@latest github repo-analyze --repository myorg/myrepo --include issues,prs
```
diff --git a/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md b/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md
index bff58985bb..ea30c88edd 100644
--- a/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md
+++ b/v3/@claude-flow/cli/.claude/commands/github/repo-architect.md
@@ -113,9 +113,9 @@ mcp__github__push_files {
## Quick Start
\`\`\`bash
-npx claude-flow init --sparc
+npx @claude-flow/cli@latest init --sparc
npm install
-npx claude-flow start --ui
+npx @claude-flow/cli@latest start --ui
\`\`\`
## Features
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md
index 846cbe371f..28254885c9 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-consensus.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-consensus in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-consensus [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-consensus [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md
index cdf319c030..8a6b31b804 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-init.md
@@ -4,7 +4,7 @@ Initialize the Hive Mind collective intelligence system.
## Usage
```bash
-npx claude-flow hive-mind init [options]
+npx @claude-flow/cli@latest hive-mind init [options]
```
## Options
@@ -13,6 +13,6 @@ npx claude-flow hive-mind init [options]
## Examples
```bash
-npx claude-flow hive-mind init
-npx claude-flow hive-mind init --force
+npx @claude-flow/cli@latest hive-mind init
+npx @claude-flow/cli@latest hive-mind init --force
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md
index d4c926394d..401544e365 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-memory.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-memory in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-memory [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-memory [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md
index 7c83ddb666..f618d88974 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-metrics.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-metrics in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-metrics [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-metrics [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md
index 999c924c70..6668e04e85 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-resume.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-resume in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-resume [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-resume [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md
index d0e2ea6797..06eb8ad3d7 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-sessions.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-sessions in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-sessions [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-sessions [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md
index a3bded7dff..0ff58ea7ff 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-spawn.md
@@ -4,7 +4,7 @@ Spawn a Hive Mind swarm with queen-led coordination.
## Usage
```bash
-npx claude-flow hive-mind spawn <objective> [options]
+npx @claude-flow/cli@latest hive-mind spawn <objective> [options]
```
## Options
@@ -15,7 +15,7 @@ npx claude-flow hive-mind spawn <objective> [options]
## Examples
```bash
-npx claude-flow hive-mind spawn "Build API"
-npx claude-flow hive-mind spawn "Research patterns" --queen-type adaptive
-npx claude-flow hive-mind spawn "Build service" --claude
+npx @claude-flow/cli@latest hive-mind spawn "Build API"
+npx @claude-flow/cli@latest hive-mind spawn "Research patterns" --queen-type adaptive
+npx @claude-flow/cli@latest hive-mind spawn "Build service" --claude
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md
index 77853e139c..f2b5e7530c 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-status.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-status in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-status [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-status [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md
index d34d01f273..92d8832ab6 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-stop.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-stop in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-stop [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-stop [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md
index af47456256..d2c8506ad2 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind-wizard.md
@@ -4,5 +4,5 @@ Command documentation for hive-mind-wizard in category hive-mind.
Usage:
```bash
-npx claude-flow hive-mind hive-mind-wizard [options]
+npx @claude-flow/cli@latest hive-mind hive-mind-wizard [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md
index 1a860e32fa..36d70c8088 100644
--- a/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md
+++ b/v3/@claude-flow/cli/.claude/commands/hive-mind/hive-mind.md
@@ -4,7 +4,7 @@ Hive Mind collective intelligence system for advanced swarm coordination.
## Usage
```bash
-npx claude-flow hive-mind [subcommand] [options]
+npx @claude-flow/cli@latest hive-mind [subcommand] [options]
```
## Subcommands
@@ -17,11 +17,11 @@ npx claude-flow hive-mind [subcommand] [options]
## Examples
```bash
# Initialize hive mind
-npx claude-flow hive-mind init
+npx @claude-flow/cli@latest hive-mind init
# Spawn swarm
-npx claude-flow hive-mind spawn "Build microservices"
+npx @claude-flow/cli@latest hive-mind spawn "Build microservices"
# Check status
-npx claude-flow hive-mind status
+npx @claude-flow/cli@latest hive-mind status
```
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/overview.md b/v3/@claude-flow/cli/.claude/commands/hooks/overview.md
index 46a7e1cd27..0675e1b614 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/overview.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/overview.md
@@ -37,7 +37,7 @@ Hooks are configured in `.claude/settings.json`:
"matcher": "^(Write|Edit|MultiEdit)$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}'"
+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}'"
}]
}
]
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md b/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md
index a5a73f94bc..421004e9a1 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/post-edit.md
@@ -5,7 +5,7 @@ Execute post-edit processing including formatting, validation, and memory update
## Usage
```bash
-npx claude-flow hook post-edit [options]
+npx @claude-flow/cli@latest hook post-edit [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow hook post-edit [options]
### Basic post-edit hook
```bash
-npx claude-flow hook post-edit --file "src/components/Button.jsx"
+npx @claude-flow/cli@latest hook post-edit --file "src/components/Button.jsx"
```
### With memory storage
```bash
-npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
+npx @claude-flow/cli@latest hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
```
### Format and validate
```bash
-npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
+npx @claude-flow/cli@latest hook post-edit -f "config/webpack.js" --auto-format --validate-output
```
### Neural training
```bash
-npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
+npx @claude-flow/cli@latest hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
```
## Features
@@ -86,7 +86,7 @@ Manual usage in agents:
```bash
# After editing files
-npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
+npx @claude-flow/cli@latest hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md b/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md
index 3140149a78..bfc9f32fa6 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/post-task.md
@@ -5,7 +5,7 @@ Execute post-task cleanup, performance analysis, and memory storage.
## Usage
```bash
-npx claude-flow hook post-task [options]
+npx @claude-flow/cli@latest hook post-task [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow hook post-task [options]
### Basic post-task hook
```bash
-npx claude-flow hook post-task --task-id "auth-implementation"
+npx @claude-flow/cli@latest hook post-task --task-id "auth-implementation"
```
### With full analysis
```bash
-npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
+npx @claude-flow/cli@latest hook post-task -t "api-refactor" --analyze-performance --generate-report
```
### Memory storage
```bash
-npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
+npx @claude-flow/cli@latest hook post-task -t "bug-fix-123" --store-decisions --export-learnings
```
### Quick cleanup
```bash
-npx claude-flow hook post-task -t "minor-update" --analyze-performance false
+npx @claude-flow/cli@latest hook post-task -t "minor-update" --analyze-performance false
```
## Features
@@ -85,7 +85,7 @@ Manual usage in agents:
```bash
# In agent coordination
-npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
+npx @claude-flow/cli@latest hook post-task --task-id "your-task-id" --analyze-performance true
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md b/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md
index d7744c5759..efe2a8dfee 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/pre-edit.md
@@ -5,7 +5,7 @@ Execute pre-edit validations and agent assignment before file modifications.
## Usage
```bash
-npx claude-flow hook pre-edit [options]
+npx @claude-flow/cli@latest hook pre-edit [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow hook pre-edit [options]
### Basic pre-edit hook
```bash
-npx claude-flow hook pre-edit --file "src/auth/login.js"
+npx @claude-flow/cli@latest hook pre-edit --file "src/auth/login.js"
```
### With validation
```bash
-npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
+npx @claude-flow/cli@latest hook pre-edit -f "config/database.js" --validate-syntax
```
### Manual agent assignment
```bash
-npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
+npx @claude-flow/cli@latest hook pre-edit -f "api/users.ts" --auto-assign-agent false
```
### Safe editing with backup
```bash
-npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
+npx @claude-flow/cli@latest hook pre-edit -f "production.env" --backup-file --check-conflicts
```
## Features
@@ -86,7 +86,7 @@ Manual usage in agents:
```bash
# Before editing files
-npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
+npx @claude-flow/cli@latest hook pre-edit --file "path/to/file.js" --validate-syntax
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md b/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md
index b2f3f5e9f2..db5d928deb 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/pre-task.md
@@ -5,7 +5,7 @@ Execute pre-task preparations and context loading.
## Usage
```bash
-npx claude-flow hook pre-task [options]
+npx @claude-flow/cli@latest hook pre-task [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow hook pre-task [options]
### Basic pre-task hook
```bash
-npx claude-flow hook pre-task --description "Implement user authentication"
+npx @claude-flow/cli@latest hook pre-task --description "Implement user authentication"
```
### With memory loading
```bash
-npx claude-flow hook pre-task -d "Continue API development" --load-memory
+npx @claude-flow/cli@latest hook pre-task -d "Continue API development" --load-memory
```
### Manual agent control
```bash
-npx claude-flow hook pre-task -d "Debug issue #123" --auto-spawn-agents false
+npx @claude-flow/cli@latest hook pre-task -d "Debug issue #123" --auto-spawn-agents false
```
### Full optimization
```bash
-npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
+npx @claude-flow/cli@latest hook pre-task -d "Refactor codebase" --optimize-topology --estimate-complexity
```
## Features
@@ -85,7 +85,7 @@ Manual usage in agents:
```bash
# In agent coordination
-npx claude-flow hook pre-task --description "Your task here"
+npx @claude-flow/cli@latest hook pre-task --description "Your task here"
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md b/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md
index 9f164e1b49..84cd8a0777 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/session-end.md
@@ -5,7 +5,7 @@ Cleanup and persist session state before ending work.
## Usage
```bash
-npx claude-flow hook session-end [options]
+npx @claude-flow/cli@latest hook session-end [options]
```
## Options
@@ -21,25 +21,25 @@ npx claude-flow hook session-end [options]
### Basic session end
```bash
-npx claude-flow hook session-end --session-id "dev-session-2024"
+npx @claude-flow/cli@latest hook session-end --session-id "dev-session-2024"
```
### With full export
```bash
-npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary
+npx @claude-flow/cli@latest hook session-end -s "feature-auth" --export-metrics --generate-summary
```
### Quick close
```bash
-npx claude-flow hook session-end -s "quick-fix" --save-state false --cleanup-temp
+npx @claude-flow/cli@latest hook session-end -s "quick-fix" --save-state false --cleanup-temp
```
### Complete persistence
```bash
-npx claude-flow hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary
+npx @claude-flow/cli@latest hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary
```
## Features
@@ -86,7 +86,7 @@ Manual usage in agents:
```bash
# At session end
-npx claude-flow hook session-end --session-id "your-session" --generate-summary
+npx @claude-flow/cli@latest hook session-end --session-id "your-session" --generate-summary
```
## Output
diff --git a/v3/@claude-flow/cli/.claude/commands/hooks/setup.md b/v3/@claude-flow/cli/.claude/commands/hooks/setup.md
index c49dd23a6d..9ebb3cb44e 100644
--- a/v3/@claude-flow/cli/.claude/commands/hooks/setup.md
+++ b/v3/@claude-flow/cli/.claude/commands/hooks/setup.md
@@ -4,7 +4,7 @@
### 1. Initialize with Hooks
```bash
-npx claude-flow init --hooks
+npx @claude-flow/cli@latest init --hooks
```
This automatically creates:
@@ -15,10 +15,10 @@ This automatically creates:
### 2. Test Hook Functionality
```bash
# Test pre-edit hook
-npx claude-flow hook pre-edit --file test.js
+npx @claude-flow/cli@latest hook pre-edit --file test.js
# Test session summary
-npx claude-flow hook session-end --summary
+npx @claude-flow/cli@latest hook session-end --summary
```
### 3. Customize Hooks
@@ -33,7 +33,7 @@ Edit `.claude/settings.json` to customize:
"matcher": "^Write$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook pre-write --file '${tool.params.file_path}'"
+ "command": "npx @claude-flow/cli@latest hook pre-write --file '${tool.params.file_path}'"
}]
}
]
@@ -72,7 +72,7 @@ Example blocking response:
export CLAUDE_FLOW_DEBUG=true
# Test specific hook
-npx claude-flow hook pre-edit --file app.js --debug
+npx @claude-flow/cli@latest hook pre-edit --file app.js --debug
```
## Common Patterns
@@ -86,7 +86,7 @@ Already configured by default for common file types.
"matcher": "^(Write|Edit)$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
+ "command": "npx @claude-flow/cli@latest hook check-protected --file '${tool.params.file_path}'"
}]
}
```
diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md
index d42bb10bf4..c3651d0c46 100644
--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md
+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-persist.md
@@ -4,7 +4,7 @@ Persist memory across sessions.
## Usage
```bash
-npx claude-flow memory persist [options]
+npx @claude-flow/cli@latest memory persist [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow memory persist [options]
## Examples
```bash
# Export memory
-npx claude-flow memory persist --export memory-backup.json
+npx @claude-flow/cli@latest memory persist --export memory-backup.json
# Import memory
-npx claude-flow memory persist --import memory-backup.json
+npx @claude-flow/cli@latest memory persist --import memory-backup.json
# Compressed export
-npx claude-flow memory persist --export memory.gz --compress
+npx @claude-flow/cli@latest memory persist --export memory.gz --compress
```
diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md
index 87d6a13d24..7079addc4e 100644
--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md
+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-search.md
@@ -4,7 +4,7 @@ Search through stored memory.
## Usage
```bash
-npx claude-flow memory search [options]
+npx @claude-flow/cli@latest memory search [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow memory search [options]
## Examples
```bash
# Search memory
-npx claude-flow memory search --query "authentication"
+npx @claude-flow/cli@latest memory search --query "authentication"
# Pattern search
-npx claude-flow memory search --pattern "api-.*"
+npx @claude-flow/cli@latest memory search --pattern "api-.*"
# Limited results
-npx claude-flow memory search --query "config" --limit 10
+npx @claude-flow/cli@latest memory search --query "config" --limit 10
```
diff --git a/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md b/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md
index 5e640055a6..3c163a37db 100644
--- a/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md
+++ b/v3/@claude-flow/cli/.claude/commands/memory/memory-usage.md
@@ -4,7 +4,7 @@ Manage persistent memory storage.
## Usage
```bash
-npx claude-flow memory usage [options]
+npx @claude-flow/cli@latest memory usage [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow memory usage [options]
## Examples
```bash
# Store memory
-npx claude-flow memory usage --action store --key "project-config" --value '{"api": "v2"}'
+npx @claude-flow/cli@latest memory usage --action store --key "project-config" --value '{"api": "v2"}'
# Retrieve memory
-npx claude-flow memory usage --action retrieve --key "project-config"
+npx @claude-flow/cli@latest memory usage --action retrieve --key "project-config"
# List all keys
-npx claude-flow memory usage --action list
+npx @claude-flow/cli@latest memory usage --action list
```
diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md b/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md
index a3201d82d5..9e718424aa 100644
--- a/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md
+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/agent-metrics.md
@@ -4,7 +4,7 @@ View agent performance metrics.
## Usage
```bash
-npx claude-flow agent metrics [options]
+npx @claude-flow/cli@latest agent metrics [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow agent metrics [options]
## Examples
```bash
# All agents metrics
-npx claude-flow agent metrics
+npx @claude-flow/cli@latest agent metrics
# Specific agent
-npx claude-flow agent metrics --agent-id agent-001
+npx @claude-flow/cli@latest agent metrics --agent-id agent-001
# Last hour
-npx claude-flow agent metrics --period 1h
+npx @claude-flow/cli@latest agent metrics --period 1h
```
diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md b/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md
index cd0c26bf16..763a74af37 100644
--- a/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md
+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/real-time-view.md
@@ -4,7 +4,7 @@ Real-time view of swarm activity.
## Usage
```bash
-npx claude-flow monitoring real-time-view [options]
+npx @claude-flow/cli@latest monitoring real-time-view [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow monitoring real-time-view [options]
## Examples
```bash
# Start real-time view
-npx claude-flow monitoring real-time-view
+npx @claude-flow/cli@latest monitoring real-time-view
# Filter errors
-npx claude-flow monitoring real-time-view --filter errors
+npx @claude-flow/cli@latest monitoring real-time-view --filter errors
# Highlight pattern
-npx claude-flow monitoring real-time-view --highlight "API"
+npx @claude-flow/cli@latest monitoring real-time-view --highlight "API"
```
diff --git a/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md b/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md
index 790a0e4342..9917fbcaf4 100644
--- a/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md
+++ b/v3/@claude-flow/cli/.claude/commands/monitoring/swarm-monitor.md
@@ -4,7 +4,7 @@ Real-time swarm monitoring.
## Usage
```bash
-npx claude-flow swarm monitor [options]
+npx @claude-flow/cli@latest swarm monitor [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow swarm monitor [options]
## Examples
```bash
# Start monitoring
-npx claude-flow swarm monitor
+npx @claude-flow/cli@latest swarm monitor
# Custom interval
-npx claude-flow swarm monitor --interval 5000
+npx @claude-flow/cli@latest swarm monitor --interval 5000
# With metrics
-npx claude-flow swarm monitor --metrics
+npx @claude-flow/cli@latest swarm monitor --metrics
```
diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md b/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md
index 949fdca741..ca9a54cf07 100644
--- a/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md
+++ b/v3/@claude-flow/cli/.claude/commands/optimization/auto-topology.md
@@ -45,7 +45,7 @@ Result: Automatically uses hierarchical topology with architect, coder, and test
The pre-task hook automatically handles topology selection:
```json
{
- "command": "npx claude-flow hook pre-task --optimize-topology"
+ "command": "npx @claude-flow/cli@latest hook pre-task --optimize-topology"
}
```
@@ -58,5 +58,5 @@ Parameters: {"swarmId": "current"}
## CLI Usage
```bash
# Auto-optimize topology via CLI
-npx claude-flow optimize topology
+npx @claude-flow/cli@latest optimize topology
```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md b/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md
index 6ddf684c1f..9a5f0a9f74 100644
--- a/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md
+++ b/v3/@claude-flow/cli/.claude/commands/optimization/cache-manage.md
@@ -4,7 +4,7 @@ Manage operation cache for performance.
## Usage
```bash
-npx claude-flow optimization cache-manage [options]
+npx @claude-flow/cli@latest optimization cache-manage [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow optimization cache-manage [options]
## Examples
```bash
# View cache stats
-npx claude-flow optimization cache-manage --action view
+npx @claude-flow/cli@latest optimization cache-manage --action view
# Clear cache
-npx claude-flow optimization cache-manage --action clear
+npx @claude-flow/cli@latest optimization cache-manage --action clear
# Set limits
-npx claude-flow optimization cache-manage --max-size 100 --ttl 3600
+npx @claude-flow/cli@latest optimization cache-manage --max-size 100 --ttl 3600
```
diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md
index 346a8aa2fe..02c8695784 100644
--- a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md
+++ b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execute.md
@@ -4,7 +4,7 @@ Execute tasks in parallel for maximum efficiency.
## Usage
```bash
-npx claude-flow optimization parallel-execute [options]
+npx @claude-flow/cli@latest optimization parallel-execute [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow optimization parallel-execute [options]
## Examples
```bash
# Execute task list
-npx claude-flow optimization parallel-execute --tasks tasks.json
+npx @claude-flow/cli@latest optimization parallel-execute --tasks tasks.json
# Limit parallelism
-npx claude-flow optimization parallel-execute --tasks tasks.json --max-parallel 5
+npx @claude-flow/cli@latest optimization parallel-execute --tasks tasks.json --max-parallel 5
# Custom strategy
-npx claude-flow optimization parallel-execute --strategy adaptive
+npx @claude-flow/cli@latest optimization parallel-execute --strategy adaptive
```
diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md
index 9585840b65..1ce0df9515 100644
--- a/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md
+++ b/v3/@claude-flow/cli/.claude/commands/optimization/parallel-execution.md
@@ -32,7 +32,7 @@ For the REST API task:
## CLI Usage
```bash
# Execute parallel tasks via CLI
-npx claude-flow parallel "Build REST API" --max-agents 8
+npx @claude-flow/cli@latest parallel "Build REST API" --max-agents 8
```
## Performance Gains
diff --git a/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md b/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md
index f9dfb8b506..cb4dc40702 100644
--- a/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md
+++ b/v3/@claude-flow/cli/.claude/commands/optimization/topology-optimize.md
@@ -4,7 +4,7 @@ Optimize swarm topology for current workload.
## Usage
```bash
-npx claude-flow optimization topology-optimize [options]
+npx @claude-flow/cli@latest optimization topology-optimize [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow optimization topology-optimize [options]
## Examples
```bash
# Analyze and suggest
-npx claude-flow optimization topology-optimize --analyze-first
+npx @claude-flow/cli@latest optimization topology-optimize --analyze-first
# Optimize for speed
-npx claude-flow optimization topology-optimize --target speed
+npx @claude-flow/cli@latest optimization topology-optimize --target speed
# Apply changes
-npx claude-flow optimization topology-optimize --target efficiency --apply
+npx @claude-flow/cli@latest optimization topology-optimize --target efficiency --apply
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc.md b/v3/@claude-flow/cli/.claude/commands/sparc.md
index 8523bca51b..ed1a394795 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc.md
@@ -66,17 +66,17 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Run SPARC orchestrator (default)
-npx claude-flow sparc "build complete authentication system"
+npx @claude-flow/cli@latest sparc "build complete authentication system"
# Run a specific mode
-npx claude-flow sparc run architect "design API structure"
-npx claude-flow sparc run tdd "implement user service"
+npx @claude-flow/cli@latest sparc run architect "design API structure"
+npx @claude-flow/cli@latest sparc run tdd "implement user service"
# Execute full TDD workflow
-npx claude-flow sparc tdd "implement user authentication"
+npx @claude-flow/cli@latest sparc tdd "implement user authentication"
# List all modes with details
-npx claude-flow sparc modes --verbose
+npx @claude-flow/cli@latest sparc modes --verbose
# For alpha features
npx claude-flow@alpha sparc run <mode> "your task"
@@ -121,7 +121,7 @@ mcp__claude-flow__memory_usage {
### Using NPX CLI (Fallback)
```bash
# Store specifications
-npx claude-flow memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec
+npx @claude-flow/cli@latest memory store "spec_auth" "OAuth2 + JWT requirements" --namespace spec
# Store architectural decisions
./claude-flow memory store "arch_api" "RESTful microservices design" --namespace arch
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md b/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md
index 299fb586c8..600b892f6f 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/analyzer.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run analyzer "analyze codebase performance"
+npx @claude-flow/cli@latest sparc run analyzer "analyze codebase performance"
# For alpha features
npx claude-flow@alpha sparc run analyzer "analyze codebase performance"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/architect.md b/v3/@claude-flow/cli/.claude/commands/sparc/architect.md
index 5f41c5ab52..b8014a523e 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/architect.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/architect.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run architect "design microservices architecture"
+npx @claude-flow/cli@latest sparc run architect "design microservices architecture"
# For alpha features
npx claude-flow@alpha sparc run architect "design microservices architecture"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/ask.md b/v3/@claude-flow/cli/.claude/commands/sparc/ask.md
index b2f352665e..682f267398 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/ask.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/ask.md
@@ -49,16 +49,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run ask "help me choose the right mode"
+npx @claude-flow/cli@latest sparc run ask "help me choose the right mode"
# For alpha features
npx claude-flow@alpha sparc run ask "help me choose the right mode"
# With namespace
-npx claude-flow sparc run ask "your task" --namespace ask
+npx @claude-flow/cli@latest sparc run ask "your task" --namespace ask
# Non-interactive mode
-npx claude-flow sparc run ask "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run ask "your task" --non-interactive
```
### Option 3: Local Installation
@@ -90,8 +90,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "ask_context" "important decisions" --namespace ask
+npx @claude-flow/cli@latest memory store "ask_context" "important decisions" --namespace ask
# Query previous work
-npx claude-flow memory query "ask" --limit 5
+npx @claude-flow/cli@latest memory query "ask" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md b/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md
index 24dc1f6fd2..e94f9056e0 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/batch-executor.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run batch-executor "process multiple files"
+npx @claude-flow/cli@latest sparc run batch-executor "process multiple files"
# For alpha features
npx claude-flow@alpha sparc run batch-executor "process multiple files"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/code.md b/v3/@claude-flow/cli/.claude/commands/sparc/code.md
index f2e7096851..0cacbe5de7 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/code.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/code.md
@@ -41,16 +41,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run code "implement REST API endpoints"
+npx @claude-flow/cli@latest sparc run code "implement REST API endpoints"
# For alpha features
npx claude-flow@alpha sparc run code "implement REST API endpoints"
# With namespace
-npx claude-flow sparc run code "your task" --namespace code
+npx @claude-flow/cli@latest sparc run code "your task" --namespace code
# Non-interactive mode
-npx claude-flow sparc run code "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run code "your task" --non-interactive
```
### Option 3: Local Installation
@@ -82,8 +82,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "code_context" "important decisions" --namespace code
+npx @claude-flow/cli@latest memory store "code_context" "important decisions" --namespace code
# Query previous work
-npx claude-flow memory query "code" --limit 5
+npx @claude-flow/cli@latest memory query "code" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/coder.md b/v3/@claude-flow/cli/.claude/commands/sparc/coder.md
index 2dc852433c..a2718d9407 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/coder.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/coder.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run coder "implement user authentication"
+npx @claude-flow/cli@latest sparc run coder "implement user authentication"
# For alpha features
npx claude-flow@alpha sparc run coder "implement user authentication"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/debug.md b/v3/@claude-flow/cli/.claude/commands/sparc/debug.md
index 3559f241c4..a1cccf791a 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/debug.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/debug.md
@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run debug "fix memory leak in service"
+npx @claude-flow/cli@latest sparc run debug "fix memory leak in service"
# For alpha features
npx claude-flow@alpha sparc run debug "fix memory leak in service"
# With namespace
-npx claude-flow sparc run debug "your task" --namespace debug
+npx @claude-flow/cli@latest sparc run debug "your task" --namespace debug
# Non-interactive mode
-npx claude-flow sparc run debug "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run debug "your task" --non-interactive
```
### Option 3: Local Installation
@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "debug_context" "important decisions" --namespace debug
+npx @claude-flow/cli@latest memory store "debug_context" "important decisions" --namespace debug
# Query previous work
-npx claude-flow memory query "debug" --limit 5
+npx @claude-flow/cli@latest memory query "debug" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md b/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md
index 7627dae303..ea09c62d3a 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/debugger.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run debugger "fix authentication issues"
+npx @claude-flow/cli@latest sparc run debugger "fix authentication issues"
# For alpha features
npx claude-flow@alpha sparc run debugger "fix authentication issues"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/designer.md b/v3/@claude-flow/cli/.claude/commands/sparc/designer.md
index c15d54b705..123e0aaa64 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/designer.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/designer.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run designer "create dashboard UI"
+npx @claude-flow/cli@latest sparc run designer "create dashboard UI"
# For alpha features
npx claude-flow@alpha sparc run designer "create dashboard UI"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/devops.md b/v3/@claude-flow/cli/.claude/commands/sparc/devops.md
index 43f0422c77..b606260d86 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/devops.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/devops.md
@@ -61,16 +61,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run devops "deploy to AWS Lambda"
+npx @claude-flow/cli@latest sparc run devops "deploy to AWS Lambda"
# For alpha features
npx claude-flow@alpha sparc run devops "deploy to AWS Lambda"
# With namespace
-npx claude-flow sparc run devops "your task" --namespace devops
+npx @claude-flow/cli@latest sparc run devops "your task" --namespace devops
# Non-interactive mode
-npx claude-flow sparc run devops "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run devops "your task" --non-interactive
```
### Option 3: Local Installation
@@ -102,8 +102,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "devops_context" "important decisions" --namespace devops
+npx @claude-flow/cli@latest memory store "devops_context" "important decisions" --namespace devops
# Query previous work
-npx claude-flow memory query "devops" --limit 5
+npx @claude-flow/cli@latest memory query "devops" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md b/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md
index 47440c861e..1fbf324f5f 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/docs-writer.md
@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run docs-writer "create API documentation"
+npx @claude-flow/cli@latest sparc run docs-writer "create API documentation"
# For alpha features
npx claude-flow@alpha sparc run docs-writer "create API documentation"
# With namespace
-npx claude-flow sparc run docs-writer "your task" --namespace docs-writer
+npx @claude-flow/cli@latest sparc run docs-writer "your task" --namespace docs-writer
# Non-interactive mode
-npx claude-flow sparc run docs-writer "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run docs-writer "your task" --non-interactive
```
### Option 3: Local Installation
@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "docs-writer_context" "important decisions" --namespace docs-writer
+npx @claude-flow/cli@latest memory store "docs-writer_context" "important decisions" --namespace docs-writer
# Query previous work
-npx claude-flow memory query "docs-writer" --limit 5
+npx @claude-flow/cli@latest memory query "docs-writer" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md b/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md
index fba3d97a11..0db491c388 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/documenter.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run documenter "create API documentation"
+npx @claude-flow/cli@latest sparc run documenter "create API documentation"
# For alpha features
npx claude-flow@alpha sparc run documenter "create API documentation"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md b/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md
index 5a11c1a9f3..5215636d20 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/innovator.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run innovator "innovative solutions for scaling"
+npx @claude-flow/cli@latest sparc run innovator "innovative solutions for scaling"
# For alpha features
npx claude-flow@alpha sparc run innovator "innovative solutions for scaling"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/integration.md b/v3/@claude-flow/cli/.claude/commands/sparc/integration.md
index 591a89f0dc..70b8fa1833 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/integration.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/integration.md
@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run integration "connect payment service"
+npx @claude-flow/cli@latest sparc run integration "connect payment service"
# For alpha features
npx claude-flow@alpha sparc run integration "connect payment service"
# With namespace
-npx claude-flow sparc run integration "your task" --namespace integration
+npx @claude-flow/cli@latest sparc run integration "your task" --namespace integration
# Non-interactive mode
-npx claude-flow sparc run integration "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run integration "your task" --non-interactive
```
### Option 3: Local Installation
@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "integration_context" "important decisions" --namespace integration
+npx @claude-flow/cli@latest memory store "integration_context" "important decisions" --namespace integration
# Query previous work
-npx claude-flow memory query "integration" --limit 5
+npx @claude-flow/cli@latest memory query "integration" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md b/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md
index df94d213f8..fec09e7c19 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/mcp.md
@@ -69,16 +69,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run mcp "integrate with external API"
+npx @claude-flow/cli@latest sparc run mcp "integrate with external API"
# For alpha features
npx claude-flow@alpha sparc run mcp "integrate with external API"
# With namespace
-npx claude-flow sparc run mcp "your task" --namespace mcp
+npx @claude-flow/cli@latest sparc run mcp "your task" --namespace mcp
# Non-interactive mode
-npx claude-flow sparc run mcp "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run mcp "your task" --non-interactive
```
### Option 3: Local Installation
@@ -110,8 +110,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "mcp_context" "important decisions" --namespace mcp
+npx @claude-flow/cli@latest memory store "mcp_context" "important decisions" --namespace mcp
# Query previous work
-npx claude-flow memory query "mcp" --limit 5
+npx @claude-flow/cli@latest memory query "mcp" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md b/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md
index c3de400508..a6170ac4c4 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/memory-manager.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run memory-manager "organize project knowledge"
+npx @claude-flow/cli@latest sparc run memory-manager "organize project knowledge"
# For alpha features
npx claude-flow@alpha sparc run memory-manager "organize project knowledge"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md b/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md
index 94a246adcf..031859ae7f 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/optimizer.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run optimizer "optimize application performance"
+npx @claude-flow/cli@latest sparc run optimizer "optimize application performance"
# For alpha features
npx claude-flow@alpha sparc run optimizer "optimize application performance"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md b/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md
index b577751bc2..47e53aa56c 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/orchestrator.md
@@ -16,7 +16,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run orchestrator "coordinate feature development"
+npx @claude-flow/cli@latest sparc run orchestrator "coordinate feature development"
# For alpha features
npx claude-flow@alpha sparc run orchestrator "coordinate feature development"
@@ -63,13 +63,13 @@ mcp__claude-flow__task_orchestrate {
### Using NPX CLI (Fallback)
```bash
# Initialize orchestration swarm
-npx claude-flow swarm init --topology hierarchical --strategy auto --max-agents 8
+npx @claude-flow/cli@latest swarm init --topology hierarchical --strategy auto --max-agents 8
# Spawn coordinator agent
-npx claude-flow agent spawn --type coordinator --capabilities "task-planning,resource-management"
+npx @claude-flow/cli@latest agent spawn --type coordinator --capabilities "task-planning,resource-management"
# Orchestrate tasks
-npx claude-flow task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"
+npx @claude-flow/cli@latest task orchestrate --task "feature development" --strategy parallel --deps "auth,ui,api"
```
## Orchestration Patterns
@@ -119,14 +119,14 @@ mcp__claude-flow__swarm_monitor {
### Using NPX CLI (Fallback)
```bash
# 1. Initialize orchestration swarm
-npx claude-flow swarm init --topology hierarchical --max-agents 10
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 10
# 2. Create workflow
-npx claude-flow workflow create --name "feature-development" --steps "design,implement,test,deploy"
+npx @claude-flow/cli@latest workflow create --name "feature-development" --steps "design,implement,test,deploy"
# 3. Execute orchestration
-npx claude-flow sparc run orchestrator "develop user management system" --parallel --monitor
+npx @claude-flow/cli@latest sparc run orchestrator "develop user management system" --parallel --monitor
# 4. Monitor progress
-npx claude-flow swarm monitor --interval 5000
+npx @claude-flow/cli@latest swarm monitor --interval 5000
```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md b/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md
index e800eb7b85..23453a30a5 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/post-deployment-monitoring-mode.md
@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run post-deployment-monitoring-mode "monitor production metrics"
+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "monitor production metrics"
# For alpha features
npx claude-flow@alpha sparc run post-deployment-monitoring-mode "monitor production metrics"
# With namespace
-npx claude-flow sparc run post-deployment-monitoring-mode "your task" --namespace post-deployment-monitoring-mode
+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "your task" --namespace post-deployment-monitoring-mode
# Non-interactive mode
-npx claude-flow sparc run post-deployment-monitoring-mode "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run post-deployment-monitoring-mode "your task" --non-interactive
```
### Option 3: Local Installation
@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "post-deployment-monitoring-mode_context" "important decisions" --namespace post-deployment-monitoring-mode
+npx @claude-flow/cli@latest memory store "post-deployment-monitoring-mode_context" "important decisions" --namespace post-deployment-monitoring-mode
# Query previous work
-npx claude-flow memory query "post-deployment-monitoring-mode" --limit 5
+npx @claude-flow/cli@latest memory query "post-deployment-monitoring-mode" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md b/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md
index f20a60868f..196ed15c90 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/refinement-optimization-mode.md
@@ -35,16 +35,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run refinement-optimization-mode "optimize database queries"
+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "optimize database queries"
# For alpha features
npx claude-flow@alpha sparc run refinement-optimization-mode "optimize database queries"
# With namespace
-npx claude-flow sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode
+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "your task" --namespace refinement-optimization-mode
# Non-interactive mode
-npx claude-flow sparc run refinement-optimization-mode "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run refinement-optimization-mode "your task" --non-interactive
```
### Option 3: Local Installation
@@ -76,8 +76,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode
+npx @claude-flow/cli@latest memory store "refinement-optimization-mode_context" "important decisions" --namespace refinement-optimization-mode
# Query previous work
-npx claude-flow memory query "refinement-optimization-mode" --limit 5
+npx @claude-flow/cli@latest memory query "refinement-optimization-mode" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md b/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md
index ecd6be34fd..75654d37cd 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/researcher.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run researcher "research AI trends 2024"
+npx @claude-flow/cli@latest sparc run researcher "research AI trends 2024"
# For alpha features
npx claude-flow@alpha sparc run researcher "research AI trends 2024"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md b/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md
index 1464aca931..f53faf9478 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/reviewer.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run reviewer "review pull request #123"
+npx @claude-flow/cli@latest sparc run reviewer "review pull request #123"
# For alpha features
npx claude-flow@alpha sparc run reviewer "review pull request #123"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md b/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md
index fc00e3efcf..5595369d62 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/security-review.md
@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run security-review "audit API security"
+npx @claude-flow/cli@latest sparc run security-review "audit API security"
# For alpha features
npx claude-flow@alpha sparc run security-review "audit API security"
# With namespace
-npx claude-flow sparc run security-review "your task" --namespace security-review
+npx @claude-flow/cli@latest sparc run security-review "your task" --namespace security-review
# Non-interactive mode
-npx claude-flow sparc run security-review "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run security-review "your task" --non-interactive
```
### Option 3: Local Installation
@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "security-review_context" "important decisions" --namespace security-review
+npx @claude-flow/cli@latest memory store "security-review_context" "important decisions" --namespace security-review
# Query previous work
-npx claude-flow memory query "security-review" --limit 5
+npx @claude-flow/cli@latest memory query "security-review" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md b/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md
index ed477d9f11..015a347013 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/sparc-modes.md
@@ -65,19 +65,19 @@ mcp__claude-flow__swarm_monitor {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run <mode> "task description"
+npx @claude-flow/cli@latest sparc run <mode> "task description"
# For alpha features
npx claude-flow@alpha sparc run <mode> "task description"
# List all modes
-npx claude-flow sparc modes
+npx @claude-flow/cli@latest sparc modes
# Get help for a mode
-npx claude-flow sparc help <mode>
+npx @claude-flow/cli@latest sparc help <mode>
# Run with options
-npx claude-flow sparc run <mode> "task" --parallel --monitor
+npx @claude-flow/cli@latest sparc run <mode> "task" --parallel --monitor
```
### Option 3: Local Installation
@@ -126,16 +126,16 @@ mcp__claude-flow__sparc_mode {
#### Using NPX CLI (Fallback)
```bash
# 1. Architecture design
-npx claude-flow sparc run architect "design microservices"
+npx @claude-flow/cli@latest sparc run architect "design microservices"
# 2. Implementation
-npx claude-flow sparc run coder "implement services"
+npx @claude-flow/cli@latest sparc run coder "implement services"
# 3. Testing
-npx claude-flow sparc run tdd "test all services"
+npx @claude-flow/cli@latest sparc run tdd "test all services"
# 4. Review
-npx claude-flow sparc run reviewer "review implementation"
+npx @claude-flow/cli@latest sparc run reviewer "review implementation"
```
### Research and Innovation
@@ -164,11 +164,11 @@ mcp__claude-flow__sparc_mode {
#### Using NPX CLI (Fallback)
```bash
# 1. Research phase
-npx claude-flow sparc run researcher "research best practices"
+npx @claude-flow/cli@latest sparc run researcher "research best practices"
# 2. Innovation
-npx claude-flow sparc run innovator "propose novel solutions"
+npx @claude-flow/cli@latest sparc run innovator "propose novel solutions"
# 3. Documentation
-npx claude-flow sparc run documenter "document findings"
+npx @claude-flow/cli@latest sparc run documenter "document findings"
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md b/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md
index 3192d8d2dd..52e68dc8f0 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/sparc.md
@@ -63,16 +63,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run sparc "orchestrate authentication system"
+npx @claude-flow/cli@latest sparc run sparc "orchestrate authentication system"
# For alpha features
npx claude-flow@alpha sparc run sparc "orchestrate authentication system"
# With namespace
-npx claude-flow sparc run sparc "your task" --namespace sparc
+npx @claude-flow/cli@latest sparc run sparc "your task" --namespace sparc
# Non-interactive mode
-npx claude-flow sparc run sparc "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run sparc "your task" --non-interactive
```
### Option 3: Local Installation
@@ -104,8 +104,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "sparc_context" "important decisions" --namespace sparc
+npx @claude-flow/cli@latest memory store "sparc_context" "important decisions" --namespace sparc
# Query previous work
-npx claude-flow memory query "sparc" --limit 5
+npx @claude-flow/cli@latest memory query "sparc" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md b/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md
index cb253275f4..9fe8887b22 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/spec-pseudocode.md
@@ -32,16 +32,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run spec-pseudocode "define payment flow requirements"
+npx @claude-flow/cli@latest sparc run spec-pseudocode "define payment flow requirements"
# For alpha features
npx claude-flow@alpha sparc run spec-pseudocode "define payment flow requirements"
# With namespace
-npx claude-flow sparc run spec-pseudocode "your task" --namespace spec-pseudocode
+npx @claude-flow/cli@latest sparc run spec-pseudocode "your task" --namespace spec-pseudocode
# Non-interactive mode
-npx claude-flow sparc run spec-pseudocode "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run spec-pseudocode "your task" --non-interactive
```
### Option 3: Local Installation
@@ -73,8 +73,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "spec-pseudocode_context" "important decisions" --namespace spec-pseudocode
+npx @claude-flow/cli@latest memory store "spec-pseudocode_context" "important decisions" --namespace spec-pseudocode
# Query previous work
-npx claude-flow memory query "spec-pseudocode" --limit 5
+npx @claude-flow/cli@latest memory query "spec-pseudocode" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md b/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md
index c54778dd77..3223cd959f 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/supabase-admin.md
@@ -300,16 +300,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run supabase-admin "create user authentication schema"
+npx @claude-flow/cli@latest sparc run supabase-admin "create user authentication schema"
# For alpha features
npx claude-flow@alpha sparc run supabase-admin "create user authentication schema"
# With namespace
-npx claude-flow sparc run supabase-admin "your task" --namespace supabase-admin
+npx @claude-flow/cli@latest sparc run supabase-admin "your task" --namespace supabase-admin
# Non-interactive mode
-npx claude-flow sparc run supabase-admin "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run supabase-admin "your task" --non-interactive
```
### Option 3: Local Installation
@@ -341,8 +341,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "supabase-admin_context" "important decisions" --namespace supabase-admin
+npx @claude-flow/cli@latest memory store "supabase-admin_context" "important decisions" --namespace supabase-admin
# Query previous work
-npx claude-flow memory query "supabase-admin" --limit 5
+npx @claude-flow/cli@latest memory query "supabase-admin" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md b/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md
index 0454c51e9a..a8d01ed521 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/swarm-coordinator.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run swarm-coordinator "manage development swarm"
+npx @claude-flow/cli@latest sparc run swarm-coordinator "manage development swarm"
# For alpha features
npx claude-flow@alpha sparc run swarm-coordinator "manage development swarm"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md b/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md
index a711770938..51d725697a 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tdd.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run tdd "shopping cart feature"
+npx @claude-flow/cli@latest sparc run tdd "shopping cart feature"
# For alpha features
npx claude-flow@alpha sparc run tdd "shopping cart feature"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tester.md b/v3/@claude-flow/cli/.claude/commands/sparc/tester.md
index 1d02c7eed5..fbdfe03d82 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/tester.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tester.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run tester "full regression suite"
+npx @claude-flow/cli@latest sparc run tester "full regression suite"
# For alpha features
npx claude-flow@alpha sparc run tester "full regression suite"
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md b/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md
index 156d3fba22..834ef5488c 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/tutorial.md
@@ -31,16 +31,16 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run tutorial "guide me through SPARC methodology"
+npx @claude-flow/cli@latest sparc run tutorial "guide me through SPARC methodology"
# For alpha features
npx claude-flow@alpha sparc run tutorial "guide me through SPARC methodology"
# With namespace
-npx claude-flow sparc run tutorial "your task" --namespace tutorial
+npx @claude-flow/cli@latest sparc run tutorial "your task" --namespace tutorial
# Non-interactive mode
-npx claude-flow sparc run tutorial "your task" --non-interactive
+npx @claude-flow/cli@latest sparc run tutorial "your task" --non-interactive
```
### Option 3: Local Installation
@@ -72,8 +72,8 @@ mcp__claude-flow__memory_search {
### Using NPX CLI (Fallback)
```bash
# Store mode-specific context
-npx claude-flow memory store "tutorial_context" "important decisions" --namespace tutorial
+npx @claude-flow/cli@latest memory store "tutorial_context" "important decisions" --namespace tutorial
# Query previous work
-npx claude-flow memory query "tutorial" --limit 5
+npx @claude-flow/cli@latest memory query "tutorial" --limit 5
```
diff --git a/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md b/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md
index 5c449de7a3..6a2feab718 100644
--- a/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md
+++ b/v3/@claude-flow/cli/.claude/commands/sparc/workflow-manager.md
@@ -20,7 +20,7 @@ mcp__claude-flow__sparc_mode {
### Option 2: Using NPX CLI (Fallback when MCP not available)
```bash
# Use when running from terminal or MCP tools unavailable
-npx claude-flow sparc run workflow-manager "automate deployment"
+npx @claude-flow/cli@latest sparc run workflow-manager "automate deployment"
# For alpha features
npx claude-flow@alpha sparc run workflow-manager "automate deployment"
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md b/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md
index a60ebcd6c8..19354e6b91 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/analysis.md
@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "analyze system performance" --strategy analysis`
+`npx @claude-flow/cli@latest swarm "analyze system performance" --strategy analysis`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/development.md b/v3/@claude-flow/cli/.claude/commands/swarm/development.md
index b106ed88f0..785254675a 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/development.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/development.md
@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "build feature X" --strategy development`
+`npx @claude-flow/cli@latest swarm "build feature X" --strategy development`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/examples.md b/v3/@claude-flow/cli/.claude/commands/swarm/examples.md
index 8d60b2d44c..3380257bea 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/examples.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/examples.md
@@ -35,7 +35,7 @@ mcp__claude-flow__swarm_status({
#### Using CLI (Fallback)
```bash
-npx claude-flow swarm "research AI trends" \
+npx @claude-flow/cli@latest swarm "research AI trends" \
--strategy research \
--mode distributed \
--max-agents 6 \
@@ -85,7 +85,7 @@ mcp__claude-flow__swarm_monitor({
#### Using CLI (Fallback)
```bash
-npx claude-flow swarm "build REST API" \
+npx @claude-flow/cli@latest swarm "build REST API" \
--strategy development \
--mode hierarchical \
--monitor \
@@ -134,7 +134,7 @@ mcp__claude-flow__performance_report({
#### Using CLI (Fallback)
```bash
-npx claude-flow swarm "analyze codebase" \
+npx @claude-flow/cli@latest swarm "analyze codebase" \
--strategy analysis \
--mode mesh \
--parallel \
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md b/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md
index f91e6d0b4a..155630a3d4 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/maintenance.md
@@ -24,7 +24,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "update dependencies" --strategy maintenance`
+`npx @claude-flow/cli@latest swarm "update dependencies" --strategy maintenance`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md b/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md
index ca0bd2bd6b..1b4e13a4ae 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/optimization.md
@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "optimize performance" --strategy optimization`
+`npx @claude-flow/cli@latest swarm "optimize performance" --strategy optimization`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/research.md b/v3/@claude-flow/cli/.claude/commands/swarm/research.md
index fbdd0343a0..53c653cbdc 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/research.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/research.md
@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "research topic X" --strategy research`
+`npx @claude-flow/cli@latest swarm "research topic X" --strategy research`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md
index 1168d1b181..a5bbd4006a 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-analysis.md
@@ -4,5 +4,5 @@ Command documentation for swarm-analysis in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-analysis [options]
+npx @claude-flow/cli@latest swarm swarm-analysis [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md
index 055330c839..b0983d751e 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-background.md
@@ -4,5 +4,5 @@ Command documentation for swarm-background in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-background [options]
+npx @claude-flow/cli@latest swarm swarm-background [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md
index 1644941666..2d0399c0f5 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-init.md
@@ -4,7 +4,7 @@ Initialize a new swarm with specified topology.
## Usage
```bash
-npx claude-flow swarm init [options]
+npx @claude-flow/cli@latest swarm init [options]
```
## Options
@@ -14,6 +14,6 @@ npx claude-flow swarm init [options]
## Examples
```bash
-npx claude-flow swarm init --topology mesh
-npx claude-flow swarm init --topology hierarchical --max-agents 8
+npx @claude-flow/cli@latest swarm init --topology mesh
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md
index 1818013d75..b9290d7d9e 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-modes.md
@@ -4,5 +4,5 @@ Command documentation for swarm-modes in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-modes [options]
+npx @claude-flow/cli@latest swarm swarm-modes [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md
index 8c526bdc4d..e4f1521499 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-monitor.md
@@ -4,5 +4,5 @@ Command documentation for swarm-monitor in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-monitor [options]
+npx @claude-flow/cli@latest swarm swarm-monitor [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md
index b10ece8b06..1be34e12aa 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-spawn.md
@@ -4,7 +4,7 @@ Spawn agents in the swarm.
## Usage
```bash
-npx claude-flow swarm spawn [options]
+npx @claude-flow/cli@latest swarm spawn [options]
```
## Options
@@ -14,6 +14,6 @@ npx claude-flow swarm spawn [options]
## Examples
```bash
-npx claude-flow swarm spawn --type coder --count 3
-npx claude-flow swarm spawn --type researcher --capabilities "web-search,analysis"
+npx @claude-flow/cli@latest swarm spawn --type coder --count 3
+npx @claude-flow/cli@latest swarm spawn --type researcher --capabilities "web-search,analysis"
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md
index 20fadfb8c5..9bd9c5de65 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-status.md
@@ -4,5 +4,5 @@ Command documentation for swarm-status in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-status [options]
+npx @claude-flow/cli@latest swarm swarm-status [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md
index 3712a909a9..ef91049adc 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/swarm-strategies.md
@@ -4,5 +4,5 @@ Command documentation for swarm-strategies in category swarm.
Usage:
```bash
-npx claude-flow swarm swarm-strategies [options]
+npx @claude-flow/cli@latest swarm swarm-strategies [options]
```
diff --git a/v3/@claude-flow/cli/.claude/commands/swarm/testing.md b/v3/@claude-flow/cli/.claude/commands/swarm/testing.md
index e2b8af3c34..034db206a5 100644
--- a/v3/@claude-flow/cli/.claude/commands/swarm/testing.md
+++ b/v3/@claude-flow/cli/.claude/commands/swarm/testing.md
@@ -23,7 +23,7 @@ mcp__claude-flow__task_orchestrate({
```
### Using CLI (Fallback)
-`npx claude-flow swarm "test application" --strategy testing`
+`npx @claude-flow/cli@latest swarm "test application" --strategy testing`
## Agent Roles
diff --git a/v3/@claude-flow/cli/.claude/commands/training/model-update.md b/v3/@claude-flow/cli/.claude/commands/training/model-update.md
index 5e81b25dae..9a576d5308 100644
--- a/v3/@claude-flow/cli/.claude/commands/training/model-update.md
+++ b/v3/@claude-flow/cli/.claude/commands/training/model-update.md
@@ -4,7 +4,7 @@ Update neural models with new data.
## Usage
```bash
-npx claude-flow training model-update [options]
+npx @claude-flow/cli@latest training model-update [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow training model-update [options]
## Examples
```bash
# Update all models
-npx claude-flow training model-update
+npx @claude-flow/cli@latest training model-update
# Specific model
-npx claude-flow training model-update --model agent-selector
+npx @claude-flow/cli@latest training model-update --model agent-selector
# Incremental with validation
-npx claude-flow training model-update --incremental --validate
+npx @claude-flow/cli@latest training model-update --incremental --validate
```
diff --git a/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md b/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md
index c22c2450b7..a014e7188e 100644
--- a/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md
+++ b/v3/@claude-flow/cli/.claude/commands/training/neural-patterns.md
@@ -23,13 +23,13 @@ Every successful operation trains the neural networks:
### 2. Manual Training
```bash
# Train coordination patterns (50 epochs)
-npx claude-flow neural train -p coordination -e 50
+npx @claude-flow/cli@latest neural train -p coordination -e 50
# Train optimization patterns with custom learning rate
-npx claude-flow neural train -p optimization -l 0.005
+npx @claude-flow/cli@latest neural train -p optimization -l 0.005
# Quick training (10 epochs)
-npx claude-flow neural train -e 10
+npx @claude-flow/cli@latest neural train -e 10
```
### 3. Pattern Types
@@ -50,20 +50,20 @@ npx claude-flow neural train -e 10
### 4. Improvement Tracking
```bash
# Check neural system status
-npx claude-flow neural status
+npx @claude-flow/cli@latest neural status
```
## Pattern Management
```bash
# List all persisted patterns
-npx claude-flow neural patterns --action list
+npx @claude-flow/cli@latest neural patterns --action list
# Search patterns by query
-npx claude-flow neural patterns --action list -q "error handling"
+npx @claude-flow/cli@latest neural patterns --action list -q "error handling"
# Analyze patterns
-npx claude-flow neural patterns --action analyze -q "coordination"
+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"
```
## Performance Targets
@@ -85,19 +85,19 @@ npx claude-flow neural patterns --action analyze -q "coordination"
```bash
# Train neural patterns
-npx claude-flow neural train -p coordination -e 50
+npx @claude-flow/cli@latest neural train -p coordination -e 50
# Check neural status
-npx claude-flow neural status
+npx @claude-flow/cli@latest neural status
# List patterns
-npx claude-flow neural patterns --action list
+npx @claude-flow/cli@latest neural patterns --action list
# Search patterns
-npx claude-flow neural patterns --action list -q "query"
+npx @claude-flow/cli@latest neural patterns --action list -q "query"
# Analyze patterns
-npx claude-flow neural patterns --action analyze -q "coordination"
+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"
```
## Related Commands
diff --git a/v3/@claude-flow/cli/.claude/commands/training/neural-train.md b/v3/@claude-flow/cli/.claude/commands/training/neural-train.md
index c50aa04f8d..0b20d8ab66 100644
--- a/v3/@claude-flow/cli/.claude/commands/training/neural-train.md
+++ b/v3/@claude-flow/cli/.claude/commands/training/neural-train.md
@@ -4,7 +4,7 @@ Train neural patterns with SONA (Self-Optimizing Neural Architecture) for adapti
## Usage
```bash
-npx claude-flow neural train [options]
+npx @claude-flow/cli@latest neural train [options]
```
## Options
@@ -27,16 +27,16 @@ Patterns survive process restarts and are loaded automatically on next session.
```bash
# Train coordination patterns (50 epochs)
-npx claude-flow neural train -p coordination -e 50
+npx @claude-flow/cli@latest neural train -p coordination -e 50
# Train with custom learning rate
-npx claude-flow neural train -p optimization -l 0.005
+npx @claude-flow/cli@latest neural train -p optimization -l 0.005
# Train from file
-npx claude-flow neural train -d ./training-data.json
+npx @claude-flow/cli@latest neural train -d ./training-data.json
# Quick training (10 epochs)
-npx claude-flow neural train -e 10
+npx @claude-flow/cli@latest neural train -e 10
```
## Output
@@ -51,13 +51,13 @@ Training produces:
```bash
# List all persisted patterns
-npx claude-flow neural patterns --action list
+npx @claude-flow/cli@latest neural patterns --action list
# Search patterns by query
-npx claude-flow neural patterns --action list -q "error handling"
+npx @claude-flow/cli@latest neural patterns --action list -q "error handling"
# Analyze patterns
-npx claude-flow neural patterns --action analyze -q "coordination"
+npx @claude-flow/cli@latest neural patterns --action analyze -q "coordination"
```
## Performance Targets
diff --git a/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md b/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md
index 56da6be88b..1315363db0 100644
--- a/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md
+++ b/v3/@claude-flow/cli/.claude/commands/training/pattern-learn.md
@@ -4,7 +4,7 @@ Learn patterns from successful operations.
## Usage
```bash
-npx claude-flow training pattern-learn [options]
+npx @claude-flow/cli@latest training pattern-learn [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow training pattern-learn [options]
## Examples
```bash
# Learn from all ops
-npx claude-flow training pattern-learn
+npx @claude-flow/cli@latest training pattern-learn
# High success only
-npx claude-flow training pattern-learn --threshold 0.9
+npx @claude-flow/cli@latest training pattern-learn --threshold 0.9
# Save patterns
-npx claude-flow training pattern-learn --save optimal-patterns
+npx @claude-flow/cli@latest training pattern-learn --save optimal-patterns
```
diff --git a/v3/@claude-flow/cli/.claude/commands/training/specialization.md b/v3/@claude-flow/cli/.claude/commands/training/specialization.md
index 329f8ece20..e1561876ed 100644
--- a/v3/@claude-flow/cli/.claude/commands/training/specialization.md
+++ b/v3/@claude-flow/cli/.claude/commands/training/specialization.md
@@ -56,8 +56,8 @@ Agents share learnings across sessions for cumulative expertise!
## CLI Usage
```bash
# Train agent specialization via CLI
-npx claude-flow train agent --type coder --capabilities "react,typescript"
+npx @claude-flow/cli@latest train agent --type coder --capabilities "react,typescript"
# Check specializations
-npx claude-flow agent list --specializations
+npx @claude-flow/cli@latest agent list --specializations
```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/development.md b/v3/@claude-flow/cli/.claude/commands/workflows/development.md
index 84fc7dd845..cad7051895 100644
--- a/v3/@claude-flow/cli/.claude/commands/workflows/development.md
+++ b/v3/@claude-flow/cli/.claude/commands/workflows/development.md
@@ -68,11 +68,11 @@ Remember: All code is written by Claude Code using its native tools!
## CLI Usage
```bash
# Start development workflow via CLI
-npx claude-flow workflow dev "REST API with auth"
+npx @claude-flow/cli@latest workflow dev "REST API with auth"
# Create custom workflow
-npx claude-flow workflow create --name "api-dev" --steps "design,implement,test,deploy"
+npx @claude-flow/cli@latest workflow create --name "api-dev" --steps "design,implement,test,deploy"
# Execute saved workflow
-npx claude-flow workflow execute api-dev
+npx @claude-flow/cli@latest workflow execute api-dev
```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/research.md b/v3/@claude-flow/cli/.claude/commands/workflows/research.md
index 7eed3e299b..a6f4718343 100644
--- a/v3/@claude-flow/cli/.claude/commands/workflows/research.md
+++ b/v3/@claude-flow/cli/.claude/commands/workflows/research.md
@@ -56,8 +56,8 @@ Remember: The swarm coordinates HOW Claude Code researches, not WHAT it finds.
## CLI Usage
```bash
# Start research workflow via CLI
-npx claude-flow workflow research "modern web frameworks"
+npx @claude-flow/cli@latest workflow research "modern web frameworks"
# Export research workflow
-npx claude-flow workflow export research --format json
+npx @claude-flow/cli@latest workflow export research --format json
```
\ No newline at end of file
diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md
index c4ae9cd5a7..7afe0eb026 100644
--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md
+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-create.md
@@ -4,7 +4,7 @@ Create reusable workflow templates.
## Usage
```bash
-npx claude-flow workflow create [options]
+npx @claude-flow/cli@latest workflow create [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow workflow create [options]
## Examples
```bash
# Create workflow
-npx claude-flow workflow create --name "deploy-api"
+npx @claude-flow/cli@latest workflow create --name "deploy-api"
# From history
-npx claude-flow workflow create --name "test-suite" --from-history
+npx @claude-flow/cli@latest workflow create --name "test-suite" --from-history
# Interactive mode
-npx claude-flow workflow create --interactive
+npx @claude-flow/cli@latest workflow create --interactive
```
diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md
index 1e59870710..2b05c26481 100644
--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md
+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-execute.md
@@ -4,7 +4,7 @@ Execute saved workflows.
## Usage
```bash
-npx claude-flow workflow execute [options]
+npx @claude-flow/cli@latest workflow execute [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow workflow execute [options]
## Examples
```bash
# Execute workflow
-npx claude-flow workflow execute --name "deploy-api"
+npx @claude-flow/cli@latest workflow execute --name "deploy-api"
# With parameters
-npx claude-flow workflow execute --name "test-suite" --params '{"env": "staging"}'
+npx @claude-flow/cli@latest workflow execute --name "test-suite" --params '{"env": "staging"}'
# Dry run
-npx claude-flow workflow execute --name "deploy-api" --dry-run
+npx @claude-flow/cli@latest workflow execute --name "deploy-api" --dry-run
```
diff --git a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md
index 6dd2479b65..e95cb0f485 100644
--- a/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md
+++ b/v3/@claude-flow/cli/.claude/commands/workflows/workflow-export.md
@@ -4,7 +4,7 @@ Export workflows for sharing.
## Usage
```bash
-npx claude-flow workflow export [options]
+npx @claude-flow/cli@latest workflow export [options]
```
## Options
@@ -15,11 +15,11 @@ npx claude-flow workflow export [options]
## Examples
```bash
# Export workflow
-npx claude-flow workflow export --name "deploy-api"
+npx @claude-flow/cli@latest workflow export --name "deploy-api"
# As YAML
-npx claude-flow workflow export --name "test-suite" --format yaml
+npx @claude-flow/cli@latest workflow export --name "test-suite" --format yaml
# With history
-npx claude-flow workflow export --name "deploy-api" --include-history
+npx @claude-flow/cli@latest workflow export --name "deploy-api" --include-history
```
diff --git a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs
index e0764c25cf..409f689703 100755
--- a/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs
+++ b/v3/@claude-flow/cli/.claude/helpers/auto-memory-hook.mjs
@@ -189,7 +189,7 @@ async function loadMemoryPackage() {
}
// Strategy 2: Use createRequire for CJS-style resolution (handles nested node_modules
- // when installed as a transitive dependency via npx ruflo / npx claude-flow)
+ // when installed as a transitive dependency via npx ruflo / npx @claude-flow/cli@latest)
try {
const { createRequire } = await import('module');
const require = createRequire(join(PROJECT_ROOT, 'package.json'));
diff --git a/v3/@claude-flow/cli/.claude/helpers/github-setup.sh b/v3/@claude-flow/cli/.claude/helpers/github-setup.sh
index f235ab69d6..ce966bc4e2 100755
--- a/v3/@claude-flow/cli/.claude/helpers/github-setup.sh
+++ b/v3/@claude-flow/cli/.claude/helpers/github-setup.sh
@@ -39,7 +39,7 @@ fi
echo ""
echo "GitHub swarm commands available:"
-echo " - npx claude-flow github swarm"
-echo " - npx claude-flow repo analyze"
-echo " - npx claude-flow pr enhance"
-echo " - npx claude-flow issue triage"
+echo " - npx @claude-flow/cli@latest github swarm"
+echo " - npx @claude-flow/cli@latest repo analyze"
+echo " - npx @claude-flow/cli@latest pr enhance"
+echo " - npx @claude-flow/cli@latest issue triage"
diff --git a/v3/@claude-flow/cli/.claude/helpers/quick-start.sh b/v3/@claude-flow/cli/.claude/helpers/quick-start.sh
index 37a07840b7..4fed4eef66 100755
--- a/v3/@claude-flow/cli/.claude/helpers/quick-start.sh
+++ b/v3/@claude-flow/cli/.claude/helpers/quick-start.sh
@@ -5,15 +5,15 @@ echo "πŸš€ Claude Flow Quick Start"
echo "=========================="
echo ""
echo "1. Initialize a swarm:"
-echo " npx claude-flow swarm init --topology hierarchical"
+echo " npx @claude-flow/cli@latest swarm init --topology hierarchical"
echo ""
echo "2. Spawn agents:"
-echo " npx claude-flow agent spawn --type coder --name "API Developer""
+echo " npx @claude-flow/cli@latest agent spawn --type coder --name "API Developer""
echo ""
echo "3. Orchestrate tasks:"
-echo " npx claude-flow task orchestrate --task "Build REST API""
+echo " npx @claude-flow/cli@latest task orchestrate --task "Build REST API""
echo ""
echo "4. Monitor progress:"
-echo " npx claude-flow swarm monitor"
+echo " npx @claude-flow/cli@latest swarm monitor"
echo ""
echo "πŸ“š For more examples, see .claude/commands/"
diff --git a/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh b/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh
index d50d89152b..695334d7e8 100755
--- a/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh
+++ b/v3/@claude-flow/cli/.claude/helpers/setup-mcp.sh
@@ -12,7 +12,7 @@ fi
# Add MCP server
echo "πŸ“¦ Adding Claude Flow MCP server..."
-claude mcp add claude-flow npx claude-flow mcp start
+claude mcp add claude-flow npx @claude-flow/cli@latest mcp start
echo "βœ… MCP server setup complete!"
echo "🎯 You can now use mcp__claude-flow__ tools in Claude Code"
diff --git a/v3/@claude-flow/cli/.claude/settings.json b/v3/@claude-flow/cli/.claude/settings.json
index 029f8c6380..e0201d750d 100644
--- a/v3/@claude-flow/cli/.claude/settings.json
+++ b/v3/@claude-flow/cli/.claude/settings.json
@@ -105,7 +105,7 @@
"permissions": {
"allow": [
"Bash(npx @claude-flow*)",
- "Bash(npx claude-flow*)",
+ "Bash(npx @claude-flow/cli@latest*)",
"Bash(node .claude/*)",
"mcp__claude-flow__:*"
],
diff --git a/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md b/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md
index 38424c1061..1bc847580c 100644
--- a/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md
+++ b/v3/@claude-flow/cli/.claude/skills/dual-mode/dual-spawn.md
@@ -51,7 +51,7 @@ Spawn multiple headless Codex workers to run tasks in parallel while you continu
```bash
# Initialize coordination
-npx claude-flow swarm init --topology hierarchical --max-agents {{workers}}
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents {{workers}}
# Spawn workers
{{#each workers}}
@@ -77,5 +77,5 @@ Use `/dual-collect` to gather results:
Or check manually:
```bash
-npx claude-flow memory list --namespace results
+npx @claude-flow/cli@latest memory list --namespace results
```
diff --git a/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md b/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md
index 4b87d1000b..d985dd05e8 100644
--- a/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md
+++ b/v3/@claude-flow/cli/.claude/skills/github-multi-repo/SKILL.md
@@ -29,12 +29,12 @@ Cross-package integration testing and deployment coordination.
### Initialize Multi-Repo Coordination
```bash
# Basic swarm initialization
-npx claude-flow skill run github-multi-repo init \
+npx @claude-flow/cli@latest skill run github-multi-repo init \
--repos "org/frontend,org/backend,org/shared" \
--topology hierarchical
# Advanced initialization with synchronization
-npx claude-flow skill run github-multi-repo init \
+npx @claude-flow/cli@latest skill run github-multi-repo init \
--repos "org/frontend,org/backend,org/shared" \
--topology mesh \
--shared-memory \
@@ -44,7 +44,7 @@ npx claude-flow skill run github-multi-repo init \
### Synchronize Packages
```bash
# Synchronize package versions and dependencies
-npx claude-flow skill run github-multi-repo sync \
+npx @claude-flow/cli@latest skill run github-multi-repo sync \
--packages "claude-code-flow,ruv-swarm" \
--align-versions \
--update-docs
@@ -53,7 +53,7 @@ npx claude-flow skill run github-multi-repo sync \
### Optimize Architecture
```bash
# Analyze and optimize repository structure
-npx claude-flow skill run github-multi-repo optimize \
+npx @claude-flow/cli@latest skill run github-multi-repo optimize \
--analyze-structure \
--suggest-improvements \
--create-templates
@@ -577,7 +577,7 @@ kafka:
### 1. Microservices Coordination
```bash
-npx claude-flow skill run github-multi-repo microservices \
+npx @claude-flow/cli@latest skill run github-multi-repo microservices \
--services "auth,users,orders,payments" \
--ensure-compatibility \
--sync-contracts \
@@ -586,7 +586,7 @@ npx claude-flow skill run github-multi-repo microservices \
### 2. Library Updates
```bash
-npx claude-flow skill run github-multi-repo lib-update \
+npx @claude-flow/cli@latest skill run github-multi-repo lib-update \
--library "org/shared-lib" \
--version "2.0.0" \
--find-consumers \
@@ -596,7 +596,7 @@ npx claude-flow skill run github-multi-repo lib-update \
### 3. Organization-Wide Changes
```bash
-npx claude-flow skill run github-multi-repo org-policy \
+npx @claude-flow/cli@latest skill run github-multi-repo org-policy \
--policy "add-security-headers" \
--repos "org/*" \
--validate-compliance \
@@ -662,7 +662,7 @@ ruv-FANN/
### Multi-Repo Dashboard
```bash
-npx claude-flow skill run github-multi-repo dashboard \
+npx @claude-flow/cli@latest skill run github-multi-repo dashboard \
--port 3000 \
--metrics "agent-activity,task-progress,memory-usage" \
--real-time
@@ -670,7 +670,7 @@ npx claude-flow skill run github-multi-repo dashboard \
### Dependency Graph
```bash
-npx claude-flow skill run github-multi-repo dep-graph \
+npx @claude-flow/cli@latest skill run github-multi-repo dep-graph \
--format mermaid \
--include-agents \
--show-data-flow
@@ -678,7 +678,7 @@ npx claude-flow skill run github-multi-repo dep-graph \
### Health Monitoring
```bash
-npx claude-flow skill run github-multi-repo health-check \
+npx @claude-flow/cli@latest skill run github-multi-repo health-check \
--repos "org/*" \
--check "connectivity,memory,agents" \
--alert-on-issues
@@ -718,7 +718,7 @@ npx claude-flow skill run github-multi-repo health-check \
### Caching Strategy
```bash
-npx claude-flow skill run github-multi-repo cache-strategy \
+npx @claude-flow/cli@latest skill run github-multi-repo cache-strategy \
--analyze-patterns \
--suggest-cache-layers \
--implement-invalidation
@@ -726,7 +726,7 @@ npx claude-flow skill run github-multi-repo cache-strategy \
### Parallel Execution
```bash
-npx claude-flow skill run github-multi-repo parallel-optimize \
+npx @claude-flow/cli@latest skill run github-multi-repo parallel-optimize \
--analyze-dependencies \
--identify-parallelizable \
--execute-optimal
@@ -734,7 +734,7 @@ npx claude-flow skill run github-multi-repo parallel-optimize \
### Resource Pooling
```bash
-npx claude-flow skill run github-multi-repo resource-pool \
+npx @claude-flow/cli@latest skill run github-multi-repo resource-pool \
--share-agents \
--distribute-load \
--monitor-usage
@@ -744,7 +744,7 @@ npx claude-flow skill run github-multi-repo resource-pool \
### Connectivity Issues
```bash
-npx claude-flow skill run github-multi-repo diagnose-connectivity \
+npx @claude-flow/cli@latest skill run github-multi-repo diagnose-connectivity \
--test-all-repos \
--check-permissions \
--verify-webhooks
@@ -752,7 +752,7 @@ npx claude-flow skill run github-multi-repo diagnose-connectivity \
### Memory Synchronization
```bash
-npx claude-flow skill run github-multi-repo debug-memory \
+npx @claude-flow/cli@latest skill run github-multi-repo debug-memory \
--check-consistency \
--identify-conflicts \
--repair-state
@@ -760,7 +760,7 @@ npx claude-flow skill run github-multi-repo debug-memory \
### Performance Bottlenecks
```bash
-npx claude-flow skill run github-multi-repo perf-analysis \
+npx @claude-flow/cli@latest skill run github-multi-repo perf-analysis \
--profile-operations \
--identify-bottlenecks \
--suggest-optimizations
@@ -770,7 +770,7 @@ npx claude-flow skill run github-multi-repo perf-analysis \
### 1. Distributed Task Queue
```bash
-npx claude-flow skill run github-multi-repo queue \
+npx @claude-flow/cli@latest skill run github-multi-repo queue \
--backend redis \
--workers 10 \
--priority-routing \
@@ -779,7 +779,7 @@ npx claude-flow skill run github-multi-repo queue \
### 2. Cross-Repo Testing
```bash
-npx claude-flow skill run github-multi-repo test \
+npx @claude-flow/cli@latest skill run github-multi-repo test \
--setup-test-env \
--link-services \
--run-e2e \
@@ -788,7 +788,7 @@ npx claude-flow skill run github-multi-repo test \
### 3. Monorepo Migration
```bash
-npx claude-flow skill run github-multi-repo to-monorepo \
+npx @claude-flow/cli@latest skill run github-multi-repo to-monorepo \
--analyze-repos \
--suggest-structure \
--preserve-history \
@@ -799,7 +799,7 @@ npx claude-flow skill run github-multi-repo to-monorepo \
### Full-Stack Application Update
```bash
-npx claude-flow skill run github-multi-repo fullstack-update \
+npx @claude-flow/cli@latest skill run github-multi-repo fullstack-update \
--frontend "org/web-app" \
--backend "org/api-server" \
--database "org/db-migrations" \
@@ -808,7 +808,7 @@ npx claude-flow skill run github-multi-repo fullstack-update \
### Cross-Team Collaboration
```bash
-npx claude-flow skill run github-multi-repo cross-team \
+npx @claude-flow/cli@latest skill run github-multi-repo cross-team \
--teams "frontend,backend,devops" \
--task "implement-feature-x" \
--assign-by-expertise \
diff --git a/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md b/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md
index 7d2b9a23ba..6deb7098e7 100644
--- a/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md
+++ b/v3/@claude-flow/cli/.claude/skills/github-release-management/SKILL.md
@@ -19,7 +19,7 @@ gh release create v2.0.0 \
--title "Release v2.0.0"
# Orchestrate with swarm
-npx claude-flow github release-create \
+npx @claude-flow/cli@latest github release-create \
--version "2.0.0" \
--build-artifacts \
--deploy-targets "npm,docker,github"
@@ -28,10 +28,10 @@ npx claude-flow github release-create \
### Full Automated Release
```bash
# Initialize release swarm
-npx claude-flow swarm init --topology hierarchical
+npx @claude-flow/cli@latest swarm init --topology hierarchical
# Execute complete release pipeline
-npx claude-flow sparc pipeline "Release v2.0.0 with full validation"
+npx @claude-flow/cli@latest sparc pipeline "Release v2.0.0 with full validation"
```
---
@@ -212,7 +212,7 @@ COMMITS=$(gh api repos/:owner/:repo/compare/v1.0.0...HEAD \
--jq '.commits[].commit.message')
# Generate categorized changelog
-npx claude-flow github changelog \
+npx @claude-flow/cli@latest github changelog \
--prs "$PRS" \
--commits "$COMMITS" \
--from v1.0.0 \
@@ -231,7 +231,7 @@ npx claude-flow github changelog \
#### Version Agent
```bash
# Intelligent version suggestion
-npx claude-flow github version-suggest \
+npx @claude-flow/cli@latest github version-suggest \
--current v1.2.3 \
--analyze-commits \
--check-compatibility \
@@ -248,7 +248,7 @@ npx claude-flow github version-suggest \
#### Build Agent
```bash
# Multi-platform build coordination
-npx claude-flow github release-build \
+npx @claude-flow/cli@latest github release-build \
--platforms "linux,macos,windows" \
--architectures "x64,arm64" \
--parallel \
@@ -265,7 +265,7 @@ npx claude-flow github release-build \
#### Test Agent
```bash
# Comprehensive pre-release testing
-npx claude-flow github release-test \
+npx @claude-flow/cli@latest github release-test \
--suites "unit,integration,e2e,performance" \
--environments "node:16,node:18,node:20" \
--fail-fast false \
@@ -275,7 +275,7 @@ npx claude-flow github release-test \
#### Deploy Agent
```bash
# Multi-target deployment orchestration
-npx claude-flow github release-deploy \
+npx @claude-flow/cli@latest github release-deploy \
--targets "npm,docker,github,s3" \
--staged-rollout \
--monitor-metrics \
@@ -352,7 +352,7 @@ deployment:
#### Execute Staged Deployment
```bash
# Deploy with progressive rollout
-npx claude-flow github release-deploy \
+npx @claude-flow/cli@latest github release-deploy \
--version v2.0.0 \
--strategy progressive \
--config .github/release-deployment.yml \
@@ -365,7 +365,7 @@ npx claude-flow github release-deploy \
#### Coordinated Multi-Repo Release
```bash
# Synchronize releases across repositories
-npx claude-flow github multi-release \
+npx @claude-flow/cli@latest github multi-release \
--repos "frontend:v2.0.0,backend:v2.1.0,cli:v1.5.0" \
--ensure-compatibility \
--atomic-release \
@@ -399,7 +399,7 @@ npx claude-flow github multi-release \
#### Emergency Hotfix Workflow
```bash
# Fast-track critical bug fix
-npx claude-flow github emergency-release \
+npx @claude-flow/cli@latest github emergency-release \
--issue 789 \
--severity critical \
--target-version v1.2.4 \
@@ -561,7 +561,7 @@ release:
#### Comprehensive Validation Suite
```bash
# Pre-release validation with all checks
-npx claude-flow github release-validate \
+npx @claude-flow/cli@latest github release-validate \
--checks "
version-conflicts,
dependency-compatibility,
@@ -580,7 +580,7 @@ npx claude-flow github release-validate \
#### Backward Compatibility Testing
```bash
# Test against previous versions
-npx claude-flow github compat-test \
+npx @claude-flow/cli@latest github compat-test \
--previous-versions "v1.0,v1.1,v1.2" \
--api-contracts \
--data-migrations \
@@ -591,7 +591,7 @@ npx claude-flow github compat-test \
#### Performance Regression Detection
```bash
# Benchmark against baseline
-npx claude-flow github performance-test \
+npx @claude-flow/cli@latest github performance-test \
--baseline v1.9.0 \
--candidate v2.0.0 \
--metrics "throughput,latency,memory,cpu" \
@@ -604,7 +604,7 @@ npx claude-flow github performance-test \
#### Real-Time Release Monitoring
```bash
# Monitor release health post-deployment
-npx claude-flow github release-monitor \
+npx @claude-flow/cli@latest github release-monitor \
--version v2.0.0 \
--metrics "error-rate,latency,throughput,adoption" \
--alert-thresholds \
@@ -615,7 +615,7 @@ npx claude-flow github release-monitor \
#### Release Analytics & Insights
```bash
# Analyze release performance and adoption
-npx claude-flow github release-analytics \
+npx @claude-flow/cli@latest github release-analytics \
--version v2.0.0 \
--compare-with v1.9.0 \
--metrics "adoption,performance,stability,feedback" \
@@ -626,7 +626,7 @@ npx claude-flow github release-analytics \
#### Automated Rollback Configuration
```bash
# Configure intelligent auto-rollback
-npx claude-flow github rollback-config \
+npx @claude-flow/cli@latest github rollback-config \
--triggers '{
"error-rate": ">5%",
"latency-p99": ">1000ms",
@@ -643,7 +643,7 @@ npx claude-flow github rollback-config \
#### Security Scanning
```bash
# Comprehensive security validation
-npx claude-flow github release-security \
+npx @claude-flow/cli@latest github release-security \
--scan-dependencies \
--check-secrets \
--audit-permissions \
@@ -655,7 +655,7 @@ npx claude-flow github release-security \
#### Compliance Validation
```bash
# Ensure regulatory compliance
-npx claude-flow github release-compliance \
+npx @claude-flow/cli@latest github release-compliance \
--standards "SOC2,GDPR,HIPAA" \
--license-audit \
--data-governance \
diff --git a/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md b/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md
index 7acce959ef..9cd019b9ac 100644
--- a/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md
+++ b/v3/@claude-flow/cli/.claude/skills/hooks-automation/SKILL.md
@@ -38,7 +38,7 @@ This skill provides a comprehensive hook system that automatically manages devel
```bash
# Initialize with default hooks configuration
-npx claude-flow init --hooks
+npx @claude-flow/cli@latest init --hooks
```
This creates:
@@ -50,13 +50,13 @@ This creates:
```bash
# Pre-task hook (auto-spawns agents)
-npx claude-flow hook pre-task --description "Implement authentication"
+npx @claude-flow/cli@latest hook pre-task --description "Implement authentication"
# Post-edit hook (auto-formats and stores in memory)
-npx claude-flow hook post-edit --file "src/auth.js" --memory-key "auth/login"
+npx @claude-flow/cli@latest hook post-edit --file "src/auth.js" --memory-key "auth/login"
# Session end hook (saves state and metrics)
-npx claude-flow hook session-end --session-id "dev-session" --export-metrics
+npx @claude-flow/cli@latest hook session-end --session-id "dev-session" --export-metrics
```
---
@@ -71,7 +71,7 @@ Hooks that execute BEFORE operations to prepare and validate:
**pre-edit** - Validate and assign agents before file modifications
```bash
-npx claude-flow hook pre-edit [options]
+npx @claude-flow/cli@latest hook pre-edit [options]
Options:
--file, -f <path> File path to be edited
@@ -81,9 +81,9 @@ Options:
--backup-file Create backup before editing
Examples:
- npx claude-flow hook pre-edit --file "src/auth/login.js"
- npx claude-flow hook pre-edit -f "config/db.js" --validate-syntax
- npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
+ npx @claude-flow/cli@latest hook pre-edit --file "src/auth/login.js"
+ npx @claude-flow/cli@latest hook pre-edit -f "config/db.js" --validate-syntax
+ npx @claude-flow/cli@latest hook pre-edit -f "production.env" --backup-file --check-conflicts
```
**Features:**
@@ -94,7 +94,7 @@ Examples:
**pre-bash** - Check command safety and resource requirements
```bash
-npx claude-flow hook pre-bash --command <cmd>
+npx @claude-flow/cli@latest hook pre-bash --command <cmd>
Options:
--command, -c <cmd> Command to validate
@@ -103,8 +103,8 @@ Options:
--require-confirmation Request user confirmation for risky commands
Examples:
- npx claude-flow hook pre-bash -c "rm -rf /tmp/cache"
- npx claude-flow hook pre-bash --command "docker build ." --estimate-resources
+ npx @claude-flow/cli@latest hook pre-bash -c "rm -rf /tmp/cache"
+ npx @claude-flow/cli@latest hook pre-bash --command "docker build ." --estimate-resources
```
**Features:**
@@ -115,7 +115,7 @@ Examples:
**pre-task** - Auto-spawn agents and prepare for complex tasks
```bash
-npx claude-flow hook pre-task [options]
+npx @claude-flow/cli@latest hook pre-task [options]
Options:
--description, -d <text> Task description for context
@@ -125,9 +125,9 @@ Options:
--estimate-complexity Analyze task complexity
Examples:
- npx claude-flow hook pre-task --description "Implement user authentication"
- npx claude-flow hook pre-task -d "Continue API dev" --load-memory
- npx claude-flow hook pre-task -d "Refactor codebase" --optimize-topology
+ npx @claude-flow/cli@latest hook pre-task --description "Implement user authentication"
+ npx @claude-flow/cli@latest hook pre-task -d "Continue API dev" --load-memory
+ npx @claude-flow/cli@latest hook pre-task -d "Refactor codebase" --optimize-topology
```
**Features:**
@@ -138,7 +138,7 @@ Examples:
**pre-search** - Prepare and optimize search operations
```bash
-npx claude-flow hook pre-search --query <query>
+npx @claude-flow/cli@latest hook pre-search --query <query>
Options:
--query, -q <text> Search query
@@ -146,7 +146,7 @@ Options:
--optimize-query Optimize search pattern
Examples:
- npx claude-flow hook pre-search -q "authentication middleware"
+ npx @claude-flow/cli@latest hook pre-search -q "authentication middleware"
```
**Features:**
@@ -160,7 +160,7 @@ Hooks that execute AFTER operations to process and learn:
**post-edit** - Auto-format, validate, and update memory
```bash
-npx claude-flow hook post-edit [options]
+npx @claude-flow/cli@latest hook post-edit [options]
Options:
--file, -f <path> File path that was edited
@@ -170,9 +170,9 @@ Options:
--validate-output Validate edited file
Examples:
- npx claude-flow hook post-edit --file "src/components/Button.jsx"
- npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login"
- npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns
+ npx @claude-flow/cli@latest hook post-edit --file "src/components/Button.jsx"
+ npx @claude-flow/cli@latest hook post-edit -f "api/auth.js" --memory-key "auth/login"
+ npx @claude-flow/cli@latest hook post-edit -f "utils/helpers.ts" --train-patterns
```
**Features:**
@@ -183,7 +183,7 @@ Examples:
**post-bash** - Log execution and update metrics
```bash
-npx claude-flow hook post-bash --command <cmd>
+npx @claude-flow/cli@latest hook post-bash --command <cmd>
Options:
--command, -c <cmd> Command that was executed
@@ -192,7 +192,7 @@ Options:
--store-result Store result in memory
Examples:
- npx claude-flow hook post-bash -c "npm test" --update-metrics
+ npx @claude-flow/cli@latest hook post-bash -c "npm test" --update-metrics
```
**Features:**
@@ -203,7 +203,7 @@ Examples:
**post-task** - Performance analysis and decision storage
```bash
-npx claude-flow hook post-task [options]
+npx @claude-flow/cli@latest hook post-task [options]
Options:
--task-id, -t <id> Task identifier for tracking
@@ -213,9 +213,9 @@ Options:
--generate-report Create task completion report
Examples:
- npx claude-flow hook post-task --task-id "auth-implementation"
- npx claude-flow hook post-task -t "api-refactor" --analyze-performance
- npx claude-flow hook post-task -t "bug-fix-123" --store-decisions
+ npx @claude-flow/cli@latest hook post-task --task-id "auth-implementation"
+ npx @claude-flow/cli@latest hook post-task -t "api-refactor" --analyze-performance
+ npx @claude-flow/cli@latest hook post-task -t "bug-fix-123" --store-decisions
```
**Features:**
@@ -226,7 +226,7 @@ Examples:
**post-search** - Cache results and improve patterns
```bash
-npx claude-flow hook post-search --query <query> --results <path>
+npx @claude-flow/cli@latest hook post-search --query <query> --results <path>
Options:
--query, -q <text> Original search query
@@ -235,7 +235,7 @@ Options:
--train-patterns Improve search patterns
Examples:
- npx claude-flow hook post-search -q "auth" -r "results.json" --train-patterns
+ npx @claude-flow/cli@latest hook post-search -q "auth" -r "results.json" --train-patterns
```
**Features:**
@@ -249,7 +249,7 @@ Hooks that coordinate with MCP swarm tools:
**mcp-initialized** - Persist swarm configuration
```bash
-npx claude-flow hook mcp-initialized --swarm-id <id>
+npx @claude-flow/cli@latest hook mcp-initialized --swarm-id <id>
Features:
- Save swarm topology and configuration
@@ -259,7 +259,7 @@ Features:
**agent-spawned** - Update agent roster and memory
```bash
-npx claude-flow hook agent-spawned --agent-id <id> --type <type>
+npx @claude-flow/cli@latest hook agent-spawned --agent-id <id> --type <type>
Features:
- Register agent in coordination memory
@@ -269,7 +269,7 @@ Features:
**task-orchestrated** - Monitor task progress
```bash
-npx claude-flow hook task-orchestrated --task-id <id>
+npx @claude-flow/cli@latest hook task-orchestrated --task-id <id>
Features:
- Track task progress through memory
@@ -279,7 +279,7 @@ Features:
**neural-trained** - Save pattern improvements
```bash
-npx claude-flow hook neural-trained --pattern <name>
+npx @claude-flow/cli@latest hook neural-trained --pattern <name>
Features:
- Export trained neural patterns
@@ -309,7 +309,7 @@ Features:
**memory-sync** - Synchronize memory across swarm agents
```bash
-npx claude-flow hook memory-sync --namespace <ns>
+npx @claude-flow/cli@latest hook memory-sync --namespace <ns>
Features:
- Sync memory state across agents
@@ -322,7 +322,7 @@ Features:
**session-start** - Initialize new session
```bash
-npx claude-flow hook session-start --session-id <id>
+npx @claude-flow/cli@latest hook session-start --session-id <id>
Options:
--session-id, -s <id> Session identifier
@@ -338,7 +338,7 @@ Features:
**session-restore** - Load previous session state
```bash
-npx claude-flow hook session-restore --session-id <id>
+npx @claude-flow/cli@latest hook session-restore --session-id <id>
Options:
--session-id, -s <id> Session to restore
@@ -346,8 +346,8 @@ Options:
--restore-agents Restore agent configurations
Examples:
- npx claude-flow hook session-restore --session-id "swarm-20241019"
- npx claude-flow hook session-restore -s "feature-auth" --restore-memory
+ npx @claude-flow/cli@latest hook session-restore --session-id "swarm-20241019"
+ npx @claude-flow/cli@latest hook session-restore -s "feature-auth" --restore-memory
```
**Features:**
@@ -358,7 +358,7 @@ Examples:
**session-end** - Cleanup and persist session state
```bash
-npx claude-flow hook session-end [options]
+npx @claude-flow/cli@latest hook session-end [options]
Options:
--session-id, -s <id> Session identifier to end
@@ -368,9 +368,9 @@ Options:
--cleanup-temp Remove temporary files
Examples:
- npx claude-flow hook session-end --session-id "dev-session-2024"
- npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary
- npx claude-flow hook session-end -s "quick-fix" --cleanup-temp
+ npx @claude-flow/cli@latest hook session-end --session-id "dev-session-2024"
+ npx @claude-flow/cli@latest hook session-end -s "feature-auth" --export-metrics --generate-summary
+ npx @claude-flow/cli@latest hook session-end -s "quick-fix" --cleanup-temp
```
**Features:**
@@ -381,7 +381,7 @@ Examples:
**notify** - Custom notifications with swarm status
```bash
-npx claude-flow hook notify --message <msg>
+npx @claude-flow/cli@latest hook notify --message <msg>
Options:
--message, -m <text> Notification message
@@ -390,8 +390,8 @@ Options:
--broadcast Send to all agents
Examples:
- npx claude-flow hook notify -m "Task completed" --level info
- npx claude-flow hook notify -m "Critical error" --level error --broadcast
+ npx @claude-flow/cli@latest hook notify -m "Task completed" --level info
+ npx @claude-flow/cli@latest hook notify -m "Critical error" --level error --broadcast
```
**Features:**
@@ -414,14 +414,14 @@ Edit `.claude/settings.json` to configure hooks:
"matcher": "^(Write|Edit|MultiEdit)$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/current'"
+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/current'"
}]
},
{
"matcher": "^Bash$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook pre-bash --command '${tool.params.command}'"
+ "command": "npx @claude-flow/cli@latest hook pre-bash --command '${tool.params.command}'"
}]
}
],
@@ -430,14 +430,14 @@ Edit `.claude/settings.json` to configure hooks:
"matcher": "^(Write|Edit|MultiEdit)$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook post-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/complete' --auto-format --train-patterns"
+ "command": "npx @claude-flow/cli@latest hook post-edit --file '${tool.params.file_path}' --memory-key 'swarm/editor/complete' --auto-format --train-patterns"
}]
},
{
"matcher": "^Bash$",
"hooks": [{
"type": "command",
- "command": "npx claude-flow hook post-bash --command '${tool.params.command}' --update-metrics"
+ "command": "npx @claude-flow/cli@latest hook post-bash --command '${tool.params.command}' --update-metrics"
}]
}
]
@@ -462,7 +462,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook pre-edit --file '${tool.params.file_path}' --auto-assign-agent --validate-syntax",
+ "command": "npx @claude-flow/cli@latest hook pre-edit --file '${tool.params.file_path}' --auto-assign-agent --validate-syntax",
"timeout": 3000,
"continueOnError": true
}
@@ -473,7 +473,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook pre-task --description '${tool.params.task}' --auto-spawn-agents --load-memory",
+ "command": "npx @claude-flow/cli@latest hook pre-task --description '${tool.params.task}' --auto-spawn-agents --load-memory",
"async": true
}
]
@@ -483,7 +483,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook pre-search --query '${tool.params.pattern}' --check-cache"
+ "command": "npx @claude-flow/cli@latest hook pre-search --query '${tool.params.pattern}' --check-cache"
}
]
}
@@ -495,7 +495,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook post-edit --file '${tool.params.file_path}' --memory-key 'edits/${tool.params.file_path}' --auto-format --train-patterns",
+ "command": "npx @claude-flow/cli@latest hook post-edit --file '${tool.params.file_path}' --memory-key 'edits/${tool.params.file_path}' --auto-format --train-patterns",
"async": true
}
]
@@ -505,7 +505,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook post-task --task-id '${result.task_id}' --analyze-performance --store-decisions --export-learnings",
+ "command": "npx @claude-flow/cli@latest hook post-task --task-id '${result.task_id}' --analyze-performance --store-decisions --export-learnings",
"async": true
}
]
@@ -515,7 +515,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook post-search --query '${tool.params.pattern}' --cache-results --train-patterns"
+ "command": "npx @claude-flow/cli@latest hook post-search --query '${tool.params.pattern}' --cache-results --train-patterns"
}
]
}
@@ -526,7 +526,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook session-start --session-id '${session.id}' --load-context"
+ "command": "npx @claude-flow/cli@latest hook session-start --session-id '${session.id}' --load-context"
}
]
}
@@ -537,7 +537,7 @@ Complete hook configuration with all features:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook session-end --session-id '${session.id}' --export-metrics --generate-summary --cleanup-temp"
+ "command": "npx @claude-flow/cli@latest hook session-end --session-id '${session.id}' --export-metrics --generate-summary --cleanup-temp"
}
]
}
@@ -559,7 +559,7 @@ Add protection for sensitive files:
"hooks": [
{
"type": "command",
- "command": "npx claude-flow hook check-protected --file '${tool.params.file_path}'"
+ "command": "npx @claude-flow/cli@latest hook check-protected --file '${tool.params.file_path}'"
}
]
}
@@ -599,7 +599,7 @@ Hooks automatically integrate with MCP tools for coordination:
```javascript
// Hook command
-npx claude-flow hook pre-task --description "Build REST API"
+npx @claude-flow/cli@latest hook pre-task --description "Build REST API"
// Internally calls MCP tools:
mcp__claude-flow__agent_spawn {
@@ -623,7 +623,7 @@ mcp__claude-flow__memory_usage {
```javascript
// Hook command
-npx claude-flow hook post-edit --file "api/auth.js"
+npx @claude-flow/cli@latest hook post-edit --file "api/auth.js"
// Internally calls MCP tools:
mcp__claude-flow__memory_usage {
@@ -649,7 +649,7 @@ mcp__claude-flow__neural_train {
```javascript
// Hook command
-npx claude-flow hook session-end --session-id "dev-2024"
+npx @claude-flow/cli@latest hook session-end --session-id "dev-2024"
// Internally calls MCP tools:
mcp__claude-flow__memory_persist {
@@ -776,7 +776,7 @@ FILES=$(git diff --cached --name-only --diff-filter=ACM)
for FILE in $FILES; do
# Run pre-edit hook for validation
- npx claude-flow hook pre-edit --file "$FILE" --validate-syntax
+ npx @claude-flow/cli@latest hook pre-edit --file "$FILE" --validate-syntax
if [ $? -ne 0 ]; then
echo "Validation failed for $FILE"
@@ -784,7 +784,7 @@ for FILE in $FILES; do
fi
# Run post-edit hook for formatting
- npx claude-flow hook post-edit --file "$FILE" --auto-format
+ npx @claude-flow/cli@latest hook post-edit --file "$FILE" --auto-format
done
# Run tests
@@ -803,7 +803,7 @@ exit $?
COMMIT_HASH=$(git rev-parse HEAD)
COMMIT_MSG=$(git log -1 --pretty=%B)
-npx claude-flow hook notify \
+npx @claude-flow/cli@latest hook notify \
--message "Commit completed: $COMMIT_MSG" \
--level info \
--swarm-status
@@ -820,12 +820,12 @@ npx claude-flow hook notify \
npm run test:all
# Run quality checks
-npx claude-flow hook session-end \
+npx @claude-flow/cli@latest hook session-end \
--generate-report \
--export-metrics
# Verify quality thresholds
-TRUTH_SCORE=$(npx claude-flow metrics score --format json | jq -r '.truth_score')
+TRUTH_SCORE=$(npx @claude-flow/cli@latest metrics score --format json | jq -r '.truth_score')
if (( $(echo "$TRUTH_SCORE < 0.95" | bc -l) )); then
echo "Truth score below threshold: $TRUTH_SCORE < 0.95"
@@ -844,13 +844,13 @@ How agents use hooks for coordination:
```bash
# Agent 1: Backend Developer
# STEP 1: Pre-task preparation
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Implement user authentication API" \
--auto-spawn-agents \
--load-memory
# STEP 2: Work begins - pre-edit validation
-npx claude-flow hook pre-edit \
+npx @claude-flow/cli@latest hook pre-edit \
--file "api/auth.js" \
--auto-assign-agent \
--validate-syntax
@@ -859,20 +859,20 @@ npx claude-flow hook pre-edit \
# ... code changes ...
# STEP 4: Post-edit processing
-npx claude-flow hook post-edit \
+npx @claude-flow/cli@latest hook post-edit \
--file "api/auth.js" \
--memory-key "swarm/backend/auth-api" \
--auto-format \
--train-patterns
# STEP 5: Notify coordination system
-npx claude-flow hook notify \
+npx @claude-flow/cli@latest hook notify \
--message "Auth API implementation complete" \
--swarm-status \
--broadcast
# STEP 6: Task completion
-npx claude-flow hook post-task \
+npx @claude-flow/cli@latest hook post-task \
--task-id "auth-api" \
--analyze-performance \
--store-decisions \
@@ -882,25 +882,25 @@ npx claude-flow hook post-task \
```bash
# Agent 2: Test Engineer (receives notification)
# STEP 1: Check memory for API details
-npx claude-flow hook session-restore \
+npx @claude-flow/cli@latest hook session-restore \
--session-id "swarm-current" \
--restore-memory
# Memory contains: swarm/backend/auth-api with implementation details
# STEP 2: Generate tests
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Write tests for auth API" \
--load-memory
# STEP 3: Create test file
-npx claude-flow hook post-edit \
+npx @claude-flow/cli@latest hook post-edit \
--file "api/auth.test.js" \
--memory-key "swarm/testing/auth-api-tests" \
--train-patterns
# STEP 4: Share test results
-npx claude-flow hook notify \
+npx @claude-flow/cli@latest hook notify \
--message "Auth API tests complete - 100% coverage" \
--broadcast
```
@@ -979,37 +979,37 @@ module.exports = {
```bash
# Session start - initialize coordination
-npx claude-flow hook session-start --session-id "fullstack-feature"
+npx @claude-flow/cli@latest hook session-start --session-id "fullstack-feature"
# Pre-task planning
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Build user profile feature - frontend + backend + tests" \
--auto-spawn-agents \
--optimize-topology
# Backend work
-npx claude-flow hook pre-edit --file "api/profile.js"
+npx @claude-flow/cli@latest hook pre-edit --file "api/profile.js"
# ... implement backend ...
-npx claude-flow hook post-edit \
+npx @claude-flow/cli@latest hook post-edit \
--file "api/profile.js" \
--memory-key "profile/backend" \
--train-patterns
# Frontend work (reads backend details from memory)
-npx claude-flow hook pre-edit --file "components/Profile.jsx"
+npx @claude-flow/cli@latest hook pre-edit --file "components/Profile.jsx"
# ... implement frontend ...
-npx claude-flow hook post-edit \
+npx @claude-flow/cli@latest hook post-edit \
--file "components/Profile.jsx" \
--memory-key "profile/frontend" \
--train-patterns
# Testing (reads both backend and frontend from memory)
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Test profile feature" \
--load-memory
# Session end - export everything
-npx claude-flow hook session-end \
+npx @claude-flow/cli@latest hook session-end \
--session-id "fullstack-feature" \
--export-metrics \
--generate-summary
@@ -1019,39 +1019,39 @@ npx claude-flow hook session-end \
```bash
# Start debugging session
-npx claude-flow hook session-start --session-id "debug-memory-leak"
+npx @claude-flow/cli@latest hook session-start --session-id "debug-memory-leak"
# Pre-task: analyze issue
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Debug memory leak in event handlers" \
--load-memory \
--estimate-complexity
# Search for event emitters
-npx claude-flow hook pre-search --query "EventEmitter"
+npx @claude-flow/cli@latest hook pre-search --query "EventEmitter"
# ... search executes ...
-npx claude-flow hook post-search \
+npx @claude-flow/cli@latest hook post-search \
--query "EventEmitter" \
--cache-results
# Fix the issue
-npx claude-flow hook pre-edit \
+npx @claude-flow/cli@latest hook pre-edit \
--file "services/events.js" \
--backup-file
# ... fix code ...
-npx claude-flow hook post-edit \
+npx @claude-flow/cli@latest hook post-edit \
--file "services/events.js" \
--memory-key "debug/memory-leak-fix" \
--validate-output
# Verify fix
-npx claude-flow hook post-task \
+npx @claude-flow/cli@latest hook post-task \
--task-id "memory-leak-fix" \
--analyze-performance \
--generate-report
# End session
-npx claude-flow hook session-end \
+npx @claude-flow/cli@latest hook session-end \
--session-id "debug-memory-leak" \
--export-metrics
```
@@ -1060,27 +1060,27 @@ npx claude-flow hook session-end \
```bash
# Initialize swarm for refactoring
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Refactor legacy codebase to modern patterns" \
--auto-spawn-agents \
--optimize-topology
# Agent 1: Code Analyzer
-npx claude-flow hook pre-task --description "Analyze code complexity"
+npx @claude-flow/cli@latest hook pre-task --description "Analyze code complexity"
# ... analysis ...
-npx claude-flow hook post-task \
+npx @claude-flow/cli@latest hook post-task \
--task-id "analysis" \
--store-decisions
# Agent 2: Refactoring (reads analysis from memory)
-npx claude-flow hook session-restore \
+npx @claude-flow/cli@latest hook session-restore \
--session-id "swarm-refactor" \
--restore-memory
for file in src/**/*.js; do
- npx claude-flow hook pre-edit --file "$file" --backup-file
+ npx @claude-flow/cli@latest hook pre-edit --file "$file" --backup-file
# ... refactor ...
- npx claude-flow hook post-edit \
+ npx @claude-flow/cli@latest hook post-edit \
--file "$file" \
--memory-key "refactor/$file" \
--auto-format \
@@ -1088,12 +1088,12 @@ for file in src/**/*.js; do
done
# Agent 3: Testing (reads refactored code from memory)
-npx claude-flow hook pre-task \
+npx @claude-flow/cli@latest hook pre-task \
--description "Generate tests for refactored code" \
--load-memory
# Broadcast completion
-npx claude-flow hook notify \
+npx @claude-flow/cli@latest hook notify \
--message "Refactoring complete - all tests passing" \
--broadcast
```
@@ -1117,13 +1117,13 @@ Enable debug mode for troubleshooting:
export CLAUDE_FLOW_DEBUG=true
# Test specific hook with verbose output
-npx claude-flow hook pre-edit --file "test.js" --debug
+npx @claude-flow/cli@latest hook pre-edit --file "test.js" --debug
# Check hook execution logs
cat .claude-flow/logs/hooks-$(date +%Y-%m-%d).log
# Validate configuration
-npx claude-flow hook validate-config
+npx @claude-flow/cli@latest hook validate-config
```
### Benefits
@@ -1183,12 +1183,12 @@ npx claude-flow hook validate-config
### Related Commands
-- `npx claude-flow init --hooks` - Initialize hooks system
-- `npx claude-flow hook --list` - List available hooks
-- `npx claude-flow hook --test <hook>` - Test specific hook
-- `npx claude-flow memory usage` - Manage memory
-- `npx claude-flow agent spawn` - Spawn agents
-- `npx claude-flow swarm init` - Initialize swarm
+- `npx @claude-flow/cli@latest init --hooks` - Initialize hooks system
+- `npx @claude-flow/cli@latest hook --list` - List available hooks
+- `npx @claude-flow/cli@latest hook --test <hook>` - Test specific hook
+- `npx @claude-flow/cli@latest memory usage` - Manage memory
+- `npx @claude-flow/cli@latest agent spawn` - Spawn agents
+- `npx @claude-flow/cli@latest swarm init` - Initialize swarm
### Integration with Other Skills
diff --git a/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md b/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md
index ab343f9525..743e868130 100644
--- a/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md
+++ b/v3/@claude-flow/cli/.claude/skills/sparc-methodology/SKILL.md
@@ -472,28 +472,28 @@ mcp__claude-flow__swarm_monitor {
```bash
# Execute specific mode
-npx claude-flow sparc run <mode> "task description"
+npx @claude-flow/cli@latest sparc run <mode> "task description"
# Use alpha features
npx claude-flow@alpha sparc run <mode> "task description"
# List all available modes
-npx claude-flow sparc modes
+npx @claude-flow/cli@latest sparc modes
# Get help for specific mode
-npx claude-flow sparc help <mode>
+npx @claude-flow/cli@latest sparc help <mode>
# Run with options
-npx claude-flow sparc run <mode> "task" --parallel --monitor
+npx @claude-flow/cli@latest sparc run <mode> "task" --parallel --monitor
# Execute TDD workflow
-npx claude-flow sparc tdd "feature description"
+npx @claude-flow/cli@latest sparc tdd "feature description"
# Batch execution
-npx claude-flow sparc batch <mode1,mode2,mode3> "task"
+npx @claude-flow/cli@latest sparc batch <mode1,mode2,mode3> "task"
# Pipeline execution
-npx claude-flow sparc pipeline "task description"
+npx @claude-flow/cli@latest sparc pipeline "task description"
```
### Method 3: Local Installation
@@ -911,58 +911,58 @@ mcp__claude-flow__sparc_mode {
```bash
# Step 1: Research and planning
-npx claude-flow sparc run researcher "authentication patterns"
+npx @claude-flow/cli@latest sparc run researcher "authentication patterns"
# Step 2: Architecture design
-npx claude-flow sparc run architect "design auth system"
+npx @claude-flow/cli@latest sparc run architect "design auth system"
# Step 3: TDD implementation
-npx claude-flow sparc tdd "user authentication feature"
+npx @claude-flow/cli@latest sparc tdd "user authentication feature"
# Step 4: Code review
-npx claude-flow sparc run reviewer "review auth implementation"
+npx @claude-flow/cli@latest sparc run reviewer "review auth implementation"
# Step 5: Documentation
-npx claude-flow sparc run documenter "document auth API"
+npx @claude-flow/cli@latest sparc run documenter "document auth API"
```
### Workflow 2: Bug Investigation
```bash
# Step 1: Analyze issue
-npx claude-flow sparc run analyzer "investigate bug #456"
+npx @claude-flow/cli@latest sparc run analyzer "investigate bug #456"
# Step 2: Debug systematically
-npx claude-flow sparc run debugger "fix memory leak in service X"
+npx @claude-flow/cli@latest sparc run debugger "fix memory leak in service X"
# Step 3: Create tests
-npx claude-flow sparc run tester "regression tests for bug #456"
+npx @claude-flow/cli@latest sparc run tester "regression tests for bug #456"
# Step 4: Review fix
-npx claude-flow sparc run reviewer "validate bug fix"
+npx @claude-flow/cli@latest sparc run reviewer "validate bug fix"
```
### Workflow 3: Performance Optimization
```bash
# Step 1: Profile performance
-npx claude-flow sparc run analyzer "profile API response times"
+npx @claude-flow/cli@latest sparc run analyzer "profile API response times"
# Step 2: Identify bottlenecks
-npx claude-flow sparc run optimizer "optimize database queries"
+npx @claude-flow/cli@latest sparc run optimizer "optimize database queries"
# Step 3: Implement improvements
-npx claude-flow sparc run coder "implement caching layer"
+npx @claude-flow/cli@latest sparc run coder "implement caching layer"
# Step 4: Benchmark results
-npx claude-flow sparc run tester "performance benchmarks"
+npx @claude-flow/cli@latest sparc run tester "performance benchmarks"
```
### Workflow 4: Complete Pipeline
```bash
# Execute full development pipeline
-npx claude-flow sparc pipeline "e-commerce checkout feature"
+npx @claude-flow/cli@latest sparc pipeline "e-commerce checkout feature"
# This automatically runs:
# 1. researcher - Gather requirements
@@ -1070,19 +1070,19 @@ mcp__claude-flow__token_usage {
```bash
# List modes
-npx claude-flow sparc modes
+npx @claude-flow/cli@latest sparc modes
# Run specific mode
-npx claude-flow sparc run <mode> "task"
+npx @claude-flow/cli@latest sparc run <mode> "task"
# TDD workflow
-npx claude-flow sparc tdd "feature"
+npx @claude-flow/cli@latest sparc tdd "feature"
# Full pipeline
-npx claude-flow sparc pipeline "task"
+npx @claude-flow/cli@latest sparc pipeline "task"
# Batch execution
-npx claude-flow sparc batch <modes> "task"
+npx @claude-flow/cli@latest sparc batch <modes> "task"
```
### Most Common MCP Calls
diff --git a/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md b/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md
index 478558e0fc..52d979c9ba 100644
--- a/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md
+++ b/v3/@claude-flow/cli/.claude/skills/swarm-advanced/SKILL.md
@@ -237,7 +237,7 @@ mcp__claude-flow__workflow_execute({
### CLI Fallback
```bash
# Quick research swarm
-npx claude-flow swarm "research AI trends in 2025" \
+npx @claude-flow/cli@latest swarm "research AI trends in 2025" \
--strategy research \
--mode distributed \
--max-agents 6 \
@@ -381,7 +381,7 @@ mcp__claude-flow__pipeline_create({
### CLI Fallback
```bash
# Quick development swarm
-npx claude-flow swarm "build REST API with authentication" \
+npx @claude-flow/cli@latest swarm "build REST API with authentication" \
--strategy development \
--mode hierarchical \
--monitor \
@@ -581,7 +581,7 @@ mcp__claude-flow__trend_analysis({
### CLI Fallback
```bash
# Quick testing swarm
-npx claude-flow swarm "test application comprehensively" \
+npx @claude-flow/cli@latest swarm "test application comprehensively" \
--strategy testing \
--mode star \
--parallel \