bitfab-cli 0.2.203 → 0.2.205

package/README.md

@@ -9,6 +9,8 @@ npx bitfab-cli init                       # Detect editors, prompt if multiple
 npx bitfab-cli init --editor claude       # Install for Claude Code
 npx bitfab-cli init --editor codex        # Install for Codex
 npx bitfab-cli init --editor cursor       # Install for Cursor
+npx bitfab-cli init --prompt "instrument the chat workflow"
+npx bitfab-cli setup --prompt "modify the billing trace"
 npx bitfab-cli session-logs enable        # Enable session log collection
 npx bitfab-cli session-logs disable       # Disable session log collection
 npx bitfab-cli session-logs status        # Show the saved session log setting

package/dist/index.js

@@ -31174,6 +31174,10 @@ function buildAnalyzeRepoCommand(base, opts = {}) {
   }
   return parts.join(" ");
 }
+function buildSetupCommand(base, prompt) {
+  const trimmedPrompt = prompt?.trim();
+  return trimmedPrompt ? `${base} ${trimmedPrompt}` : base;
+}
 function makeCliAuthCheck({
   cli,
   args,
@@ -31210,14 +31214,12 @@ function ensureCliAuthenticated(cfg) {
     throw new Error(result.message);
   }
 }
-function cliSetup(cfg, skipPermissions) {
+function cliSetup(cfg, skipPermissions, prompt) {
   ensureCliAuthenticated(cfg);
-  p2.log.info(`Launching ${cfg.setupCommand}...
+  const command = buildSetupCommand(cfg.setupCommand, prompt);
+  p2.log.info(`Launching ${command}...
 `);
-  launchCli(cfg.cli, [
-    ...skipFlags(skipPermissions, cfg.skipFlag),
-    cfg.setupCommand
-  ]);
+  launchCli(cfg.cli, [...skipFlags(skipPermissions, cfg.skipFlag), command]);
 }
 function cliAssistant(cfg, args, skipPermissions) {
   ensureCliAuthenticated(cfg);
@@ -32200,7 +32202,7 @@ var claudeAdapter = {
   label: "Claude Code",
   install: runClaudeInstall,
   ensureLatest: ensureLatestClaudePlugin,
-  setup: (skipPermissions) => cliSetup(config2, skipPermissions),
+  setup: (skipPermissions, prompt) => cliSetup(config2, skipPermissions, prompt),
   analyzeRepo: runClaudeAnalyzeRepo,
   assistant: (args, skipPermissions) => cliAssistant(config2, args, skipPermissions),
   update: (args, skipPermissions) => cliUpdate(config2, args, skipPermissions)
@@ -32563,7 +32565,7 @@ var codexAdapter = {
   label: "Codex",
   install: runCodexInstall,
   ensureLatest: ensureLatestCodexPlugin,
-  setup: (skipPermissions) => cliSetup(config3, skipPermissions),
+  setup: (skipPermissions, prompt) => cliSetup(config3, skipPermissions, prompt),
   analyzeRepo: runCodexAnalyzeRepo,
   assistant: (args, skipPermissions) => cliAssistant(config3, args, skipPermissions),
   update: (args, skipPermissions) => cliUpdate(config3, args, skipPermissions)
@@ -32630,12 +32632,13 @@ function runCursorInstall() {
 }
 function ensureLatestCursorPlugin() {
 }
-function runCursorSetup(skipPermissions) {
+function runCursorSetup(skipPermissions, prompt) {
   ensureCursorAuthenticated();
   if (skipPermissions) {
     p5.log.warn("--skip-permissions is not supported for Cursor");
   }
-  p5.log.info(`To complete setup, run ${SETUP_COMMAND3} in Cursor.`);
+  const command = buildSetupCommand(SETUP_COMMAND3, prompt);
+  p5.log.info(`To complete setup, run ${command} in Cursor.`);
 }
 async function runCursorAnalyzeRepo(captureOverride, limit, prompt) {
   ensureCursorAuthenticated();
@@ -33088,7 +33091,7 @@ async function runSetup(opts) {
   const chosen = await resolveEditor(opts);
   ADAPTERS[chosen].ensureLatest();
   const skip = await resolveSkipPermissions(opts.skipPermissions);
-  ADAPTERS[chosen].setup(skip);
+  ADAPTERS[chosen].setup(skip, opts.prompt);
 }
 async function runAssistant(opts, args) {
   const chosen = await resolveEditor(opts);
@@ -33114,7 +33117,7 @@ async function runInit(opts) {
     await runLoginCommand({ exitOnComplete: false });
   }
   const skip = await resolveSkipPermissions(opts.skipPermissions);
-  ADAPTERS[chosen].setup(skip);
+  ADAPTERS[chosen].setup(skip, opts.prompt);
   const detected = detectInstalledEditors();
   const others = detected.filter((e) => e !== chosen);
   if (others.length > 0) {
@@ -33290,12 +33293,12 @@ function startUpdateCheck() {
 var GLOBAL_HELP_TEXT = `Usage: bitfab <command> [options]
 
 Commands:
-  init [--editor <name>]              Full onboarding: plugin-install, login, and setup
+  init [--editor <name>] [--prompt <text>]  Full onboarding: plugin-install, login, and setup
   plugin-install [--editor <name>]    Install the Bitfab plugin in one editor
   login [--force]                     Authenticate with Bitfab (opens browser)
   logout                              Remove stored credentials
   session-logs [status|enable|disable] Read or update session log collection
-  setup [--editor <name>]             Launch /bitfab:setup in the editor
+  setup [--editor <name>] [--prompt <text>]  Launch /bitfab:setup in the editor
   analyze-repo [--editor <name>] [prompt]  Headless scan: draft + upload trace plans (no prompts, no code edits)
   assistant [--editor <name>] [args]  Launch /bitfab:assistant in the editor
   update [--editor <name>] [mode]      Update plugin, then launch SDK update (mode: all|plugin|sdk)
@@ -33308,12 +33311,13 @@ Options:
   --upload-logs          analyze-repo: upload the run's session logs to Bitfab (skips the prompt)
   --no-upload-logs       analyze-repo: keep session logs local (skips the prompt)
   --limit <n>            analyze-repo: cap how many draft trace plans to upload (default 5)
-  --prompt, -p <text>    analyze-repo: free-text guidance steering what to focus on
+  --prompt, -p <text>    Initial prompt for init/setup, or guidance for analyze-repo
   --force                login: re-authenticate and clear any stale Studio session first
 
 Examples:
   bitfab init                              Full setup (detect editor, install, login, setup)
   bitfab init --editor claude              Full setup for Claude Code
+  bitfab init --prompt "instrument the chat workflow"
   bitfab analyze-repo                      Scan the repo and upload draft trace plans (headless)
   bitfab analyze-repo --limit 3            Scan the repo and upload at most 3 draft trace plans
   bitfab analyze-repo "focus on billing"   Scan with free-text guidance on what to prioritize
@@ -33322,21 +33326,24 @@ Examples:
   bitfab session-logs disable              Disable session log collection
   bitfab assistant investigate             Investigate traces
   bitfab setup --skip-permissions          Setup without permission prompts
+  bitfab setup --prompt "instrument the billing agent"
   bitfab assistant --skip-permissions      Run assistant autonomously
 `;
 var COMMAND_HELP_TEXT = {
-  init: `Usage: bitfab init [--editor <name>] [--skip-permissions | --no-skip-permissions]
+  init: `Usage: bitfab init [--editor <name>] [--prompt <text>] [--skip-permissions | --no-skip-permissions]
 
 Full onboarding: install the Bitfab plugin, authenticate with Bitfab, and launch setup in the selected editor.
 
 Options:
   --editor, -e <name>    Target editor: claude, codex, cursor
+  --prompt, -p <text>    Initial prompt passed to the setup agent
   --skip-permissions     Skip permission prompts when launching the setup agent
   --no-skip-permissions  Keep permission prompts without being asked
 
 Examples:
   bitfab init
   bitfab init --editor claude
+  bitfab init --prompt "instrument the chat workflow"
   bitfab init --editor codex --no-skip-permissions
 `,
   "plugin-install": `Usage: bitfab plugin-install [--editor <name>]
@@ -33387,18 +33394,20 @@ Examples:
   bitfab session-logs enable
   bitfab session-logs disable
 `,
-  setup: `Usage: bitfab setup [--editor <name>] [--skip-permissions | --no-skip-permissions]
+  setup: `Usage: bitfab setup [--editor <name>] [--prompt <text>] [--skip-permissions | --no-skip-permissions]
 
 Launch the Bitfab setup command in the selected editor without reinstalling the plugin.
 
 Options:
   --editor, -e <name>    Target editor: claude, codex, cursor
+  --prompt, -p <text>    Initial prompt passed to the setup agent
   --skip-permissions     Skip permission prompts when launching the setup agent
   --no-skip-permissions  Keep permission prompts without being asked
 
 Examples:
   bitfab setup
   bitfab setup --editor codex
+  bitfab setup --prompt "instrument the billing agent"
   bitfab setup --skip-permissions
 `,
   "analyze-repo": `Usage: bitfab analyze-repo [--editor <name>] [--limit <n>] [--prompt <text>] [--upload-logs | --no-upload-logs] [prompt]
@@ -33519,12 +33528,18 @@ function wantsHelp(argv) {
   return getHelpTopic(argv) !== null;
 }
 var COMMAND_SPECS = {
-  init: { flags: ["editor", "skipPermissions"], unknownOption: "error" },
+  init: {
+    flags: ["editor", "skipPermissions", "prompt"],
+    unknownOption: "error"
+  },
   "plugin-install": { flags: ["editor"], unknownOption: "error" },
   login: { flags: ["force"], unknownOption: "error" },
   logout: { flags: [], unknownOption: "error" },
   "session-logs": { flags: [], unknownOption: "error" },
-  setup: { flags: ["editor", "skipPermissions"], unknownOption: "error" },
+  setup: {
+    flags: ["editor", "skipPermissions", "prompt"],
+    unknownOption: "error"
+  },
   "analyze-repo": {
     flags: ["editor", "uploadLogs", "limit", "prompt"],
     unknownOption: "error"
@@ -33679,7 +33694,7 @@ ${GLOBAL_HELP_TEXT}`
   } = parseArgs2(argv);
   const abortUpdateCheck = startUpdateCheck();
   if (command === "init") {
-    await runInit({ editor, skipPermissions });
+    await runInit({ editor, skipPermissions, prompt });
     abortUpdateCheck();
     return;
   }
@@ -33704,7 +33719,7 @@ ${GLOBAL_HELP_TEXT}`
     return;
   }
   if (command === "setup") {
-    await runSetup({ editor, skipPermissions });
+    await runSetup({ editor, skipPermissions, prompt });
     abortUpdateCheck();
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitfab-cli",
-  "version": "0.2.203",
+  "version": "0.2.205",
   "description": "Install and configure the Bitfab plugin in Claude Code, Codex, or Cursor.",
   "type": "module",
   "main": "dist/index.js",