phewsh 0.15.60 → 0.15.62

package/commands/session.js

@@ -426,27 +426,31 @@ async function main() {
   // ── The Exhale: animated brand reveal ──────────────────
   await ui.brandReveal();
 
-  // Self-aware, plain-language summary — the value prop made real with THIS
-  // machine's state. Non-technical readers get one warm sentence; the rows
-  // below give engineers the exact facts. Fail-soft: a missing piece just
-  // shortens the line, it never blocks the door.
-  (function narrativeSummary() {
+  // The welcome beat — warm, plain-language, and continuity-first. This is the
+  // "you made it" moment that frames what phewsh is FOR: one thread across every
+  // AI tool, so you switch harnesses mid-work and nothing gets re-explained.
+  // Non-technical readers get one inviting sentence; the cockpit rows below give
+  // engineers the exact facts. Fail-soft: a missing piece shortens the line, it
+  // never blocks the door.
+  (function welcome() {
     try {
       const toolCount = harnesses.filter(h => h.installed).length;
       const hasProject = intentFiles.length > 0;
       const dot = teal('●');
       const tools = `${toolCount} AI tool${toolCount !== 1 ? 's' : ''}`;
-      if (hasProject && toolCount > 0) {
-        console.log(`  ${dot} ${sage(`${tools} here, all sharing one memory of`)} ${cream(projectName)}${sage(' — so you never start this project over.')}`);
+      if (hasProject && toolCount > 1) {
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${cream(projectName)} ${sage(`and your ${tools} are aligned to one thread`)} ${slate('— switch mid-thought, nothing re-explained.')}`);
       } else if (hasProject) {
-        console.log(`  ${dot} ${sage('phewsh holds one verified memory of')} ${cream(projectName)} ${sage('— ready for whatever AI tool you bring.')}`);
-      } else if (toolCount > 0) {
-        console.log(`  ${dot} ${sage(`${tools} here.`)} ${sage('Run')} ${cream('/init')} ${sage('and they all work from one shared project memory.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('one verified memory of')} ${cream(projectName)} ${sage('— ready for whatever tool you reach for next.')}`);
+      } else if (toolCount > 1) {
+        console.log(`  ${dot} ${sage(`phew — you made it.`)} ${slate('shh,')} ${sage(`time to align your ${tools} to you and get down to business.`)} ${cream('/init')} ${sage('to begin.')}`);
+      } else if (toolCount === 1) {
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('add Codex or Gemini and phewsh keeps every tool aligned to you.')}`);
       } else {
-        console.log(`  ${dot} ${sage('Install Claude Code, Codex, or Gemini — phewsh keeps them all on the same page.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('install Claude Code, Codex, or Gemini and phewsh keeps them aligned to you.')}`);
       }
       console.log('');
-    } catch { /* the summary is a flourish, never a blocker */ }
+    } catch { /* the welcome is a flourish, never a blocker */ }
   })();
 
   if (config?.apiKey && !config.apiKey.startsWith('sk-')) {
@@ -583,6 +587,10 @@ async function main() {
     console.log(`  ${b(cream('What are you trying to do?'))}`);
     console.log(`  ${teal('1')} ${sage('Build')}  ${slate('·')}  ${teal('2')} ${sage('Research')}  ${slate('·')}  ${teal('3')} ${sage('Decide')}  ${slate('·')}  ${teal('4')} ${sage('Review')}  ${slate('·')}  ${teal('5')} ${sage('Ask another model')}`);
     console.log(`  ${slate('pick a number, or just type — your context travels with every route')}`);
+    // One quiet line to the deeper power, without dumping the whole command list:
+    // the moves that make phewsh more than a chat box — true continuity across
+    // harnesses. /help opens everything when they're ready.
+    console.log(`  ${slate('⌄ deeper:')} ${cream('/work')} ${slate('hand to a tool')} ${slate('·')} ${cream('/council')} ${slate('ask them all')} ${slate('·')} ${cream('/handoff')} ${slate('what carries over')} ${slate('·')} ${cream('/help')} ${slate('all')}`);
   }
 
   // Self-aware guidance: snapshot the session's state so phewsh can recommend
@@ -666,6 +674,7 @@ async function main() {
       const tools = continuity.toolsInThread(decisions, { project: projectName });
       const span = tools >= 2 ? slate(` · ${tools} tools, one thread`) : '';
       console.log(`  ${teal('↻')} ${sage('Picking up — ' + line)}${span} ${slate('· /thread')}`);
+      console.log(''); // breathe before "What are you trying to do?"
     } catch { /* continuity is a nicety, never a blocker */ }
   }
 
@@ -733,10 +742,8 @@ async function main() {
   console.log('');
   if (!route) {
     // Nothing to route through: no key, no agent CLIs found on this machine.
-    console.log(`  ${b(cream('Welcome to phewsh.'))}`);
-    console.log('');
-    console.log(`  ${sage('No agent CLI found (Claude Code, Codex, Gemini, Cursor, OpenCode)')}`);
-    console.log(`  ${sage('and no API key set. Either one gets you running:')}`);
+    console.log(`  ${b(cream('Two ways to get running:'))}`);
+    console.log(`  ${slate('No agent CLI found (Claude Code, Codex, Gemini, Cursor, OpenCode) and no API key yet.')}`);
     console.log('');
     console.log(`    ${teal('/key')}    ${sage('Set an API key (10 seconds)')}`);
     console.log(`    ${teal('/tour')}   ${sage('See what this does (nothing needed)')}`);
@@ -2462,7 +2469,15 @@ async function main() {
           rl.prompt();
           return;
         }
-        const target = cmdArg.trim().toLowerCase();
+        // Forgiving aliases — people type the tool's everyday name, not its id.
+        // `/use claude` should just work, not bounce off "Unknown route".
+        const USE_ALIASES = {
+          claude: 'claude-code', cc: 'claude-code', claudecode: 'claude-code',
+          gpt: 'codex', chatgpt: 'codex', openai: 'codex',
+          grokbuild: 'grok',
+        };
+        const raw = cmdArg.trim().toLowerCase();
+        const target = USE_ALIASES[raw] || raw;
         if (target === 'api') {
           if (!config?.apiKey) {
             console.log(`  ${ember('!')} ${sage('No API key set — run /key first.')}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phewsh",
-  "version": "0.15.60",
+  "version": "0.15.62",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"