@axiomatic-labs/claudeflow 2.12.144 → 2.12.146

package/bin/cli.js

@@ -1,42 +1,112 @@
 #!/usr/bin/env node
 
-// npx entry point: handles install/update and version commands directly.
-// No Go binary — downloads ZIP and extracts skill files to disk.
+// Claudeflow CLI entry point.
+//
+// Dual role:
+//   1. Package manager: `claudeflow install` / `version` (npx-friendly).
+//   2. Daily driver wrapper: `claudeflow [claude-args...]` spawns
+//      `claude` with `--append-system-prompt-file` auto-injected when
+//      an `append-system-prompt.md` is present in the project tree.
+//
+// Dispatch rules:
+//   - First arg is a known subcommand → run it.
+//   - First arg starts with `-` (a flag) → passthrough to claude.
+//   - No args:
+//       * If cwd (or an ancestor) is inside a Claudeflow project
+//         (has `.claudeflow/`), passthrough to claude.
+//       * Otherwise, run `install` to match the npx-first-time path.
 
+const fs = require('fs');
 const path = require('path');
 
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0] || '';
+const SUBCOMMANDS = new Set(['install', 'version', '--version', '-v', 'help', '--help', '-h']);
+
+function inClaudeflowProject(startDir) {
+  let dir = path.resolve(startDir);
+  const root = path.parse(dir).root;
+  while (true) {
+    if (fs.existsSync(path.join(dir, '.claudeflow'))) return true;
+    if (dir === root) return false;
+    const parent = path.dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
 
+async function runSubcommand(command) {
   switch (command) {
-    case '':
     case 'install': {
       const install = require('../lib/install.js');
       await install();
-      break;
+      return;
     }
     case 'version':
     case '--version':
     case '-v': {
       const version = require('../lib/version.js');
       await version();
-      break;
+      return;
     }
+    case 'help':
+    case '--help':
+    case '-h':
     default: {
       const ui = require('../lib/ui.js');
       ui.banner();
-      console.log('  Usage: npx @axiomatic-labs/claudeflow [command]');
+      console.log('  Usage: claudeflow [command | claude-args...]');
       console.log('');
-      console.log('  Commands:');
-      console.log(`    ${ui.CYAN}install${ui.RESET}    Install or update Claudeflow (default)`);
+      console.log('  Claudeflow commands:');
+      console.log(`    ${ui.CYAN}install${ui.RESET}    Install or update Claudeflow in the current project`);
       console.log(`    ${ui.CYAN}version${ui.RESET}    Show version info`);
+      console.log(`    ${ui.CYAN}help${ui.RESET}       Show this message`);
       console.log('');
-      break;
+      console.log('  Any other arguments are passed through to `claude`, with');
+      console.log('  `--append-system-prompt-file ./append-system-prompt.md`');
+      console.log('  auto-injected when the project ships that file.');
+      console.log('');
+      console.log('  Examples:');
+      console.log('    claudeflow                 # open claude in current project');
+      console.log('    claudeflow --continue      # continue last claude session');
+      console.log('    claudeflow -p "fix bug"    # one-shot prompt');
+      console.log('    claudeflow install         # install or update claudeflow');
+      console.log('');
+      console.log('  Env:');
+      console.log('    CLAUDEFLOW_NO_SYSTEM_PROMPT=1  skip the append-system-prompt flag');
+      return;
     }
   }
 }
 
+async function main() {
+  const args = process.argv.slice(2);
+  const first = args[0];
+
+  if (first && SUBCOMMANDS.has(first)) {
+    await runSubcommand(first);
+    return;
+  }
+
+  if (first && first.startsWith('-')) {
+    // Flags → passthrough to claude
+    require('../lib/claude-passthrough.js').run(args);
+    return;
+  }
+
+  if (!first) {
+    // No args: passthrough inside a claudeflow project, else install
+    if (inClaudeflowProject(process.cwd())) {
+      require('../lib/claude-passthrough.js').run([]);
+    } else {
+      await runSubcommand('install');
+    }
+    return;
+  }
+
+  // Unknown subcommand-looking arg → passthrough (claude owns its own
+  // subcommands like `claude mcp`, `claude config`, etc.)
+  require('../lib/claude-passthrough.js').run(args);
+}
+
 main().catch((err) => {
   console.error(err.message || err);
   process.exit(1);

package/lib/claude-passthrough.js

@@ -0,0 +1,60 @@
+// Passthrough wrapper: spawns `claude` inheriting stdio, with
+// `--append-system-prompt-file <path>` auto-injected when the project
+// ships an `append-system-prompt.md` at the repo root (walking upward
+// from cwd).
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const APPEND_PROMPT_FILENAME = 'append-system-prompt.md';
+
+function findAppendPromptFile(startDir) {
+  let dir = path.resolve(startDir);
+  const root = path.parse(dir).root;
+  while (true) {
+    const candidate = path.join(dir, APPEND_PROMPT_FILENAME);
+    if (fs.existsSync(candidate)) return candidate;
+    if (dir === root) return null;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+function userAlreadySetAppend(userArgs) {
+  return userArgs.some(
+    (a) => a === '--append-system-prompt-file' || a === '--append-system-prompt'
+  );
+}
+
+function run(userArgs) {
+  const cwd = process.cwd();
+  const disabled = process.env.CLAUDEFLOW_NO_SYSTEM_PROMPT === '1';
+  const promptPath = disabled ? null : findAppendPromptFile(cwd);
+
+  const args = [];
+  if (promptPath && !userAlreadySetAppend(userArgs)) {
+    args.push('--append-system-prompt-file', promptPath);
+  }
+  args.push(...userArgs);
+
+  const child = spawn('claude', args, { stdio: 'inherit' });
+  child.on('error', (err) => {
+    if (err.code === 'ENOENT') {
+      console.error(
+        'claudeflow: `claude` binary not found in PATH.\n' +
+          'Install Claude Code: npm i -g @anthropic-ai/claude-code'
+      );
+      process.exit(127);
+    }
+    console.error('claudeflow: failed to launch claude —', err.message);
+    process.exit(1);
+  });
+  child.on('exit', (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    else process.exit(code ?? 0);
+  });
+}
+
+module.exports = { run, findAppendPromptFile };

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.144",
+  "version": "2.12.146",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"