@bitpub/cli 2.0.1 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitpub/cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "BitPub CLI — local-first shared memory for AI agents. Six daily verbs (save/load/list/find/sync/delete), zero-config private namespace, encrypted client-side.",
   "bin": {
     "bitpub": "./bin/bitpub.js"

package/src/commands/init.js

@@ -15,6 +15,7 @@ const {
   ensureIdentity,
   ensureWorkspace,
   ensureSkill,
+  runFirstRunWelcome,
 } = require('./setup');
 const { DEFAULT_CLOUD_URL } = require('../config');
 
@@ -27,6 +28,7 @@ module.exports = function registerInit(program) {
     .option('--no-workspace', 'Skip creating a .bitpub/workspace.json in the current folder')
     .option('--workspace-label <string>', 'Override the workspace label (defaults to folder name)')
     .option('--force', 'Overwrite an existing identity (the old key is unrecoverable)')
+    .option('--no-welcome', 'Skip the post-install welcome (save first memory + open browser)')
     .option('--import-from <path>', 'Import an existing TollBit config')
     .option('--no-import', 'Skip auto-import')
     .action(async (opts) => {
@@ -41,6 +43,9 @@ module.exports = function registerInit(program) {
           ensureWorkspace({ owner: config.owner, label: opts.workspaceLabel });
         }
         await ensureSkill({});
+        if (config && !opts.localOnly && opts.welcome !== false) {
+          await runFirstRunWelcome(config);
+        }
       } catch (err) {
         console.error(`\n✗ ${err.message}`);
         process.exit(1);

package/src/commands/setup.js

@@ -23,6 +23,7 @@
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
+const { spawn } = require('child_process');
 const axios = require('axios');
 const {
   readConfig,
@@ -169,6 +170,65 @@ async function ensureSkill({ quiet = false } = {}) {
   }
 }
 
+/**
+ * First-run welcome: save the Welcome slice and (if interactive) open the
+ * browser to view it. Shared by `bitpub setup` and the deprecated
+ * `bitpub init` so any install path lands the user in the same place.
+ *
+ * Idempotent through welcome.js's `welcome_saved_at` config flag. The
+ * browser tab only opens on a *fresh* save (so re-running setup doesn't
+ * pop new tabs forever); when the slice already exists we just print a
+ * pointer to `bitpub browser`.
+ *
+ * Auto-open is gated:
+ *   - `BITPUB_SKIP_WELCOME=1`  → skip
+ *   - non-TTY stdout (CI, headless agents w/o pty) → skip with a pointer
+ *   - otherwise → spawn `bitpub welcome --serve` detached so the server
+ *     outlives this process and the user gets their shell back.
+ */
+async function runFirstRunWelcome(config) {
+  const { saveWelcomeSlice } = require('./welcome');
+
+  let result;
+  try {
+    result = await saveWelcomeSlice(config, {});
+  } catch (err) {
+    console.error(`\n(welcome: could not save first memory — ${err.message})`);
+    return;
+  }
+
+  // Re-run on an already-welcomed machine — quietly skip the browser
+  // open so a `bitpub setup` re-invocation isn't disruptive.
+  if (!result.saved) return;
+
+  console.log(`\n✓ Saved your first memory → ${result.address}  (v${result.version})`);
+
+  const skipReason = welcomeSkipReason();
+  if (skipReason) {
+    console.log(`  (skipping auto browser open: ${skipReason})`);
+    console.log('  Run `bitpub welcome --serve` to open it when you\'re ready.');
+    return;
+  }
+
+  try {
+    const child = spawn(process.execPath, [process.argv[1], 'welcome', '--serve'], {
+      detached: true,
+      stdio: 'ignore',
+    });
+    child.unref();
+    console.log('  Opening your browser at http://localhost:4141 …');
+  } catch (err) {
+    console.error(`  (could not auto-open browser: ${err.message})`);
+    console.error('  Run `bitpub welcome --serve` manually.');
+  }
+}
+
+function welcomeSkipReason() {
+  if (process.env.BITPUB_SKIP_WELCOME === '1') return 'BITPUB_SKIP_WELCOME=1';
+  if (!process.stdout.isTTY) return 'non-interactive shell';
+  return null;
+}
+
 module.exports = function registerSetup(program) {
   const setup = program
     .command('setup')
@@ -178,6 +238,7 @@ module.exports = function registerSetup(program) {
     .option('--no-anchor', 'Skip anchoring this folder as a project')
     .option('--label <string>', 'Override the project label (defaults to folder name)')
     .option('--force', 'Overwrite an existing identity (the old key is unrecoverable after this)')
+    .option('--no-welcome', 'Skip the post-install welcome (save first memory + open browser)')
     .option('--import-from <path>', 'Import an existing TollBit config (defaults to ~/.tollbit/config.json if present)')
     .option('--no-import', 'Skip auto-import even if a legacy ~/.tollbit/ config is present')
     .action(async (opts) => {
@@ -191,6 +252,15 @@ module.exports = function registerSetup(program) {
           ensureWorkspace({ owner: config.owner, label: opts.label });
         }
         await ensureSkill({});
+
+        // Welcome flow: save a first memory + open the browser. Idempotent
+        // and gated — re-running `bitpub setup` doesn't keep popping tabs.
+        // Skipped in --local-only (no cloud identity to write to) and when
+        // the user opted out via --no-welcome or BITPUB_SKIP_WELCOME=1.
+        if (config && !opts.localOnly && opts.welcome !== false) {
+          await runFirstRunWelcome(config);
+        }
+
         console.log('\nTry it:');
         console.log('  bitpub save notes "first slice"');
         console.log('  bitpub list                       # see what\'s in this project');
@@ -310,3 +380,4 @@ function maybeImportLegacyConfig({ quiet = false } = {}) {
 module.exports.ensureIdentity = ensureIdentity;
 module.exports.ensureWorkspace = ensureWorkspace;
 module.exports.ensureSkill = ensureSkill;
+module.exports.runFirstRunWelcome = runFirstRunWelcome;

package/src/commands/welcome.js

@@ -80,8 +80,8 @@ function buildWelcomeContent(config) {
     'Generate a link teammates can click to join your group namespace and',
     'read shared context. No GitHub invites, no repo access, no PRs.',
     '',
-    '> *One-click sharing coming soon. Today: `bitpub auth login --domain',
-    '> yourcompany.com` joins an existing team namespace.*',
+    '> *One-click sharing coming soon. Today: `bitpub setup team --key K',
+    '> --domain yourcompany.com` joins an existing team namespace.*',
     '',
     '### 3. See what you can build',
     '',
@@ -89,7 +89,7 @@ function buildWelcomeContent(config) {
     'can put here — research notes, prompts, drafts, agent configs, job',
     'queues. Multiple agents can read and write the same slices.',
     '',
-    '> Read the [Cookbook](https://github.com/tollbit/shared-memory-protocol/blob/main/COOKBOOK.md)',
+    '> Read the [Cookbook](https://github.com/tollbit/bitpub/blob/main/COOKBOOK.md)',
     '> for real patterns teams have built on top of these primitives.',
     '',
     '---',