@axiomatic-labs/claudeflow 2.12.145 → 2.12.147

package/lib/claude-passthrough.js

@@ -35,7 +35,12 @@ function run(userArgs) {
 
   const args = [];
   if (promptPath && !userAlreadySetAppend(userArgs)) {
-    args.push('--append-system-prompt-file', promptPath);
+    // Prefer a path relative to cwd so the flag looks identical to what
+    // the user would type manually. Fall back to absolute when the
+    // relative form would escape cwd with many `..` segments.
+    const rel = path.relative(cwd, promptPath);
+    const useRel = rel && !rel.startsWith('..' + path.sep) && rel !== '..';
+    args.push('--append-system-prompt-file', useRel ? rel : promptPath);
   }
   args.push(...userArgs);
 

package/lib/install.js

@@ -261,12 +261,42 @@ async function run() {
 
     ui.done(`Claudeflow ${version} installed.`);
 
+    // Ensure the `claudeflow` shell command is available
+    const cliStatus = ensureGlobalCli(version);
+
     // Getting started guide with project detection
-    showGettingStarted(cwd);
+    showGettingStarted(cwd, cliStatus);
   }
 }
 
-function showGettingStarted(cwd) {
+function ensureGlobalCli(version) {
+  // Returns { available: boolean, autoInstalled: boolean, error?: string }
+  if (commandExists('claudeflow')) {
+    return { available: true, autoInstalled: false };
+  }
+
+  if (process.env.CLAUDEFLOW_SKIP_GLOBAL_INSTALL === '1') {
+    return { available: false, autoInstalled: false, error: 'skipped' };
+  }
+
+  console.log('');
+  console.log(`  ${ui.DIM}Installing claudeflow CLI globally so it is available as a shell command...${ui.RESET}`);
+  try {
+    execSync(`npm install -g @axiomatic-labs/claudeflow@${version}`, {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      timeout: 120000,
+    });
+    if (commandExists('claudeflow')) {
+      return { available: true, autoInstalled: true };
+    }
+    return { available: false, autoInstalled: false, error: 'installed but not on PATH' };
+  } catch (err) {
+    const msg = err?.stderr?.toString?.() || err?.message || String(err);
+    return { available: false, autoInstalled: false, error: msg.split('\n')[0] };
+  }
+}
+
+function showGettingStarted(cwd, cliStatus = { available: false, autoInstalled: false }) {
   const MANIFESTS = ['package.json', 'pyproject.toml', 'Gemfile', 'go.mod', 'Cargo.toml', 'composer.json'];
   const SKIP_DIRS = new Set(['node_modules', 'vendor', '__pycache__', 'dist', 'build', '.next', '.nuxt', '.output', '.claude']);
 
@@ -289,7 +319,20 @@ function showGettingStarted(cwd) {
 
   console.log(`  ${ui.BOLD}Getting started:${ui.RESET}`);
   console.log('');
-  console.log(`  1. Run ${ui.CYAN}claude${ui.RESET} to start Claude Code`);
+
+  const startCommand = cliStatus.available ? 'claudeflow' : 'claude';
+  if (cliStatus.autoInstalled) {
+    console.log(`  ${ui.DIM}✓ Installed ${ui.CYAN}claudeflow${ui.RESET}${ui.DIM} globally — available as a shell command.${ui.RESET}`);
+    console.log('');
+  } else if (!cliStatus.available) {
+    console.log(`  ${ui.DIM}To get the ${ui.CYAN}claudeflow${ui.RESET}${ui.DIM} shell command, run:${ui.RESET}`);
+    console.log(`    ${ui.CYAN}npm i -g @axiomatic-labs/claudeflow${ui.RESET}`);
+    if (cliStatus.error && cliStatus.error !== 'skipped') {
+      console.log(`    ${ui.DIM}(auto-install failed: ${cliStatus.error})${ui.RESET}`);
+    }
+    console.log('');
+  }
+  console.log(`  1. Run ${ui.CYAN}${startCommand}${ui.RESET} to start Claude Code`);
 
   if (isGreenfield) {
     console.log(`  2. Type ${ui.CYAN}/claudeflow-install${ui.RESET} to start setup`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.12.145",
+  "version": "2.12.147",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"