@axiomatic-labs/claudeflow 2.12.143 → 2.12.145

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/package.json

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