phewsh 0.11.13 → 0.11.14

package/bin/phewsh.js

@@ -75,37 +75,30 @@ function showHelp() {
   const pkg = require('../package.json');
   showBrand();
   console.log(`  ${g('v' + pkg.version)}  ·  ${g('phewsh.com/cli')}\n`);
-  console.log(`  ${g('─'.repeat(48))}`);
-  console.log(`  ${b('Just type')} ${w('phewsh')} ${b('to start.')} ${g('Everything else is optional.')}`);
-  console.log(`  ${g('─'.repeat(48))}`);
+  console.log(`  ${g('The loop: define .intent/ → sync → every AI tool reads → work → repeat')}`);
   console.log('');
-  console.log(`  ${b(w('start here'))}`);
-  console.log(`    ${cyan('phewsh')}          Open AI session with your .intent/ context`);
-  console.log(`    ${cyan('phewsh clarify')}   Turn a messy idea into .intent/ artifacts`);
-  console.log(`    ${cyan('phewsh login')}     Set up identity + API key`);
+  console.log(`  ${b(w('get started'))}`);
+  console.log(`    ${cyan('phewsh')}           ${g('Open a session — create, plan, and work')}`);
+  console.log(`    ${cyan('phewsh clarify')}    ${g('Turn a messy idea into .intent/ artifacts')}`);
   console.log('');
-  console.log(`  ${b(w('.intent/ management'))}`);
-  console.log(`    ${cyan('intent')}    ${g('Create, view, and evolve .intent/ artifacts')}`);
-  console.log(`    ${cyan('gate')}      ${g('Declare constraints (budget, time, skill, urgency)')}`);
-  console.log(`    ${cyan('context')}   ${g('Export .intent/ as portable context for any AI tool')}`);
-  console.log(`    ${cyan('ai')}        ${g('One-shot AI prompt with .intent/ context injected')}`);
+  console.log(`  ${b(w('author .intent/'))}`);
+  console.log(`    ${cyan('intent')}     ${g('Create, view, evolve .intent/ artifacts')}`);
+  console.log(`    ${cyan('gate')}       ${g('Set constraints (budget, time, skill, urgency)')}`);
+  console.log(`    ${cyan('context')}    ${g('Export .intent/ for any AI tool')}`);
+  console.log(`    ${cyan('ai')}         ${g('One-shot prompt with .intent/ context')}`);
   console.log('');
-  console.log(`  ${b(w('sync'))}`);
-  console.log(`    ${cyan('watch')}     ${g('Keep AI tools in sync with .intent/ (CLAUDE.md + cloud)')}`);
-  console.log(`    ${cyan('push')}      ${g('Push .intent/ to phewsh.com/intent')}`);
-  console.log(`    ${cyan('pull')}      ${g('Pull from phewsh.com/intent to .intent/')}`);
-  console.log(`    ${cyan('serve')}     ${g('Execution bridge for phewsh.com/intent')}`);
+  console.log(`  ${b(w('sync everywhere'))}`);
+  console.log(`    ${cyan('watch')}      ${g('Auto-sync .intent/ → CLAUDE.md + cloud')}`);
+  console.log(`    ${cyan('push/pull')}  ${g('Manual sync to/from phewsh.com/intent')}`);
+  console.log(`    ${cyan('serve')}      ${g('Execution bridge — run from phewsh.com/intent')}`);
+  console.log(`    ${cyan('mcp')}        ${g('Connect AI agents via MCP protocol')}`);
   console.log('');
-  console.log(`  ${b(w('connect'))}`);
-  console.log(`    ${cyan('mcp')}       ${g('Connect AI agents via MCP protocol')}`);
-  console.log(`    ${cyan('link')}      ${g('Link local .intent/ to cloud project')}`);
+  console.log(`  ${b(w('configure'))}`);
+  console.log(`    ${cyan('login')}      ${g('Identity + API key + cloud sync')}`);
+  console.log(`    ${cyan('link')}       ${g('Link local .intent/ to cloud project')}`);
   console.log('');
-  console.log(`  ${b(w('more'))}`);
-  console.log(`    ${cyan('sap')}       ${g('Sustainable AI Protocol — usage tracking')}`);
-  console.log(`    ${cyan('style')}     ${g('Style identity — ingest, profile, sync')}`);
-  console.log(`    ${cyan('mbhd')}      ${g('MBHD music engine')}`);
-  console.log('');
-  console.log(`  ${g('Everything works without an account. Account adds sync + sharing.')}`);
+  console.log(`  ${g('Works in: Claude Code · Cursor · ChatGPT · any MCP agent')}`);
+  console.log(`  ${g('No account needed. Account adds sync + sharing.')}`);
   console.log('');
 }
 

package/commands/session.js

@@ -212,24 +212,11 @@ async function main() {
 
   // ── First-run welcome ──────────────────────────────────
   if (!config?.apiKey) {
-    console.log(`  ${b(cream('Welcome.'))}`);
-    console.log(`  ${sage('.intent/ is your project\'s working memory.')}`);
-    console.log(`  ${sage('Define it once — every AI tool reads it. No more re-explaining.')}`);
+    console.log(`  ${b(cream('Welcome to phewsh.'))}`);
     console.log('');
-    console.log(`  ${cream('To chat, you need an API key.')} ${slate('(not a subscription)')}`);
-    console.log(`  ${slate('ChatGPT Plus / Claude Pro don\'t include API access.')}`);
-    console.log(`  ${slate('API keys are pay-as-you-go — both providers offer free credits.')}`);
-    console.log('');
-    console.log(`  ${teal('1')}  ${b(cream('Anthropic'))} ${slate('(recommended)')}`);
-    console.log(`     ${sage('console.anthropic.com/settings/keys')}`);
-    console.log(`     ${slate('Direct Claude access. Best quality. ~$0.01/message.')}`);
-    console.log('');
-    console.log(`  ${teal('2')}  ${b(cream('OpenRouter'))}`);
-    console.log(`     ${sage('openrouter.ai/keys')}`);
-    console.log(`     ${slate('One key → Claude, GPT, Gemini, and more.')}`);
-    console.log('');
-    console.log(`  ${sage('Got a key?')} ${cream('/key')} ${sage('to paste it in.')}`);
-    console.log(`  ${sage('Curious?')} ${cream('/tour')} ${sage('to explore (no key needed).')}`);
+    console.log(`    ${teal('/key')}    ${sage('Set your API key (takes 10 seconds)')}`);
+    console.log(`    ${teal('/init')}   ${sage('Create .intent/ for this project')}`);
+    console.log(`    ${teal('/tour')}   ${sage('See what this does (no key needed)')}`);
     console.log('');
   } else if (!config.apiKey.startsWith('sk-')) {
     console.log(`  ${ember('!')} ${sage('Stored API key looks invalid.')}`);
@@ -238,22 +225,17 @@ async function main() {
     config.apiKey = null;
   }
 
-  // ── Project status ─────────────────────────────────────
+  // ── Project status (compact) ────────────────────────────
+  const statusParts = [cream(projectName)];
   if (intentFiles.length > 0) {
-    console.log(`  ${teal('●')} ${cream(projectName)} ${slate('·')} ${sage(intentFiles.map(f => f.file).join(', '))}`);
+    statusParts.push(teal('●') + sage(` .intent/ (${intentFiles.length} files)`));
   } else {
-    console.log(`  ${teal('●')} ${cream(projectName)} ${slate('·')} ${sage('no .intent/ context')}`);
-    console.log(`  ${slate('  run /init to create .intent/ artifacts')}`);
-  }
-  console.log(`  ${slate('  model:')} ${sage(MODELS[currentModel].name)}`);
-  if (config?.email) {
-    console.log(`  ${slate('  user:')} ${sage(config.email)}`);
+    statusParts.push(slate('no .intent/ — run /init'));
   }
+  statusParts.push(sage(MODELS[currentModel].name));
+  console.log(`  ${statusParts.join(slate('  ·  '))}`);
 
-  // ── Interop ────────────────────────────────────────────
-  ui.interopLine(config, intentFiles);
-
-  // Sync status (non-blocking)
+  // Sync status (one-line, non-blocking)
   if (config?.supabaseUserId && intentFiles.length > 0) {
     const syncResult = await Promise.race([
       checkSyncStatus(config),
@@ -261,26 +243,21 @@ async function main() {
     ]);
     if (syncResult) {
       if (syncResult.status === 'cloud-newer') {
-        console.log(`  ${ember('↓')} ${sage('Cloud is newer (' + syncResult.ago + ') — run /pull')}`);
+        console.log(`  ${ember('↓')} ${sage('Cloud newer (' + syncResult.ago + ') — /pull')}`);
       } else if (syncResult.status === 'local-newer') {
-        console.log(`  ${ember('↑')} ${sage('Local changes not pushed (' + syncResult.ago + ') — run /push')}`);
+        console.log(`  ${ember('↑')} ${sage('Local changes — /push')}`);
       } else if (syncResult.status === 'synced') {
         console.log(`  ${teal('↕')} ${slate('synced')}`);
-      } else if (syncResult.status === 'local-only') {
-        console.log(`  ${slate('↕ not linked to cloud — run /push to sync')}`);
       }
     }
   }
 
   console.log('');
-  ui.divider('line');
   if (!config?.apiKey) {
-    console.log(`  ${sage('type')} ${cream('/key')} ${sage('to get started ·')} ${cream('/tour')} ${sage('to explore ·')} ${cream('/help')} ${sage('for commands')}`);
+    console.log(`  ${cream('/key')} ${sage('to start ·')} ${cream('/tour')} ${sage('to explore ·')} ${cream('/help')} ${sage('for more')}`);
   } else {
     console.log(`  ${ui.randomTip()}`);
-    console.log(`  ${sage('type naturally ·')} ${cream('/help')} ${sage('for commands ·')} ${cream('/quit')} ${sage('to exit')}`);
   }
-  ui.divider('line');
   console.log('');
 
   const rl = readline.createInterface({
@@ -308,50 +285,47 @@ async function main() {
 
       if (cmd === 'quit' || cmd === 'exit' || cmd === 'q') {
         const turns = messages.length / 2;
+        // Clean up background children
+        if (global._phewshChildren) {
+          global._phewshChildren.forEach(c => { try { c.kill(); } catch {} });
+        }
         console.log('');
-        ui.divider('line');
         console.log(`  ${sage('session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}`);
-        ui.divider('line');
         console.log('');
         process.exit(0);
       }
 
       if (cmd === 'help' || cmd === 'h') {
         console.log('');
-        ui.divider('line');
-        console.log(`  ${b(cream('Session commands'))}`);
-        ui.divider('line');
-        console.log('');
-        console.log(`  ${cream('conversation')}`);
-        console.log(`    ${teal('/clear')}       ${sage('Clear conversation history')}`);
-        console.log(`    ${teal('/run')} ${slate('<prompt>')} ${sage('One-shot prompt (no history)')}`);
-        console.log(`    ${teal('/quit')}        ${sage('End session')}`);
+        console.log(`  ${sage('the loop: define .intent/ → sync → work → evolve → repeat')}`);
         console.log('');
-        console.log(`  ${cream('project')}`);
-        console.log(`    ${teal('/init')}        ${sage('Create .intent/ artifacts in this directory')}`);
-        console.log(`    ${teal('/clarify')}     ${sage('AI-assisted artifact generation')}`);
-        console.log(`    ${teal('/gate')}        ${sage('Declare constraints (budget, time, skill)')}`);
-        console.log(`    ${teal('/export')}      ${sage('Export portable context for other AI tools')}`);
+        console.log(`  ${cream('author .intent/')}`);
+        console.log(`    ${teal('/init')}        ${sage('Create .intent/ for this project')}`);
+        console.log(`    ${teal('/clarify')}     ${sage('Turn ideas into .intent/ artifacts')}`);
+        console.log(`    ${teal('/gate')}        ${sage('Set constraints (budget, time, skill)')}`);
         console.log(`    ${teal('/context')}     ${sage('Show loaded .intent/ files')}`);
-        console.log(`    ${teal('/reload')}      ${sage('Reload .intent/ context from disk')}`);
-        console.log(`    ${teal('/status')}      ${sage('Show session stats')}`);
+        console.log(`    ${teal('/reload')}      ${sage('Reload .intent/ from disk')}`);
         console.log('');
-        console.log(`  ${cream('sync')}`);
-        console.log(`    ${teal('/push')}        ${sage('Push .intent/ to cloud')}`);
-        console.log(`    ${teal('/pull')}        ${sage('Pull .intent/ from cloud (reloads context)')}`);
+        console.log(`  ${cream('sync everywhere')}`);
+        console.log(`    ${teal('/watch')}       ${sage('Sync .intent/ → CLAUDE.md + cloud (background)')}`);
+        console.log(`    ${teal('/export')}      ${sage('Export .intent/ for any AI tool')}`);
+        console.log(`    ${teal('/push')}        ${sage('Push to phewsh.com/intent')}`);
+        console.log(`    ${teal('/pull')}        ${sage('Pull from cloud (reloads context)')}`);
+        console.log(`    ${teal('/serve')}       ${sage('Execution bridge for phewsh.com/intent')}`);
         console.log(`    ${teal('/sync')}        ${sage('Check sync status')}`);
         console.log('');
-        console.log(`  ${cream('configuration')}`);
-        console.log(`    ${teal('/login')}       ${sage('Set up identity + cloud sync')}`);
-        console.log(`    ${teal('/key')}         ${sage('Set or update your API key')}`);
-        console.log(`    ${teal('/model')} ${slate('<name>')} ${sage('Switch model (sonnet, opus, haiku)')}`);
-        console.log(`    ${teal('/models')}      ${sage('List available models')}`);
-        console.log(`    ${teal('/provider')}    ${sage('Show current provider info')}`);
-        console.log(`    ${teal('/update')}      ${sage('Update phewsh to the latest version')}`);
+        console.log(`  ${cream('session')}`);
+        console.log(`    ${teal('/run')} ${slate('<prompt>')} ${sage('One-shot prompt (no history)')}`);
+        console.log(`    ${teal('/clear')}       ${sage('Clear conversation')}`);
+        console.log(`    ${teal('/status')}      ${sage('Session stats')}`);
+        console.log(`    ${teal('/quit')}        ${sage('Exit')}`);
         console.log('');
-        console.log(`  ${cream('explore')}`);
-        console.log(`    ${teal('/tour')}        ${sage('Guided walkthrough of PHEWSH')}`);
-        console.log(`    ${teal('/system')}      ${sage('Show current system prompt')}`);
+        console.log(`  ${cream('configure')}`);
+        console.log(`    ${teal('/key')}         ${sage('Set API key')}`);
+        console.log(`    ${teal('/login')}       ${sage('Identity + cloud sync')}`);
+        console.log(`    ${teal('/model')} ${slate('<name>')} ${sage('Switch model (sonnet, opus, haiku)')}`);
+        console.log(`    ${teal('/update')}      ${sage('Update phewsh')}`);
+        console.log(`    ${teal('/tour')}        ${sage('Quick walkthrough')}`);
         console.log('');
         rl.prompt();
         return;
@@ -717,6 +691,49 @@ async function main() {
         return;
       }
 
+      if (cmd === 'watch') {
+        if (!fs.existsSync(INTENT_DIR)) {
+          console.log(`\n  ${ember('!')} ${sage('No .intent/ found. Run /init first.')}\n`);
+          rl.prompt();
+          return;
+        }
+        const { spawn } = require('child_process');
+        const watchArgs = ['watch'];
+        if (cmdArg) watchArgs.push(...cmdArg.split(/\s+/));
+        const child = spawn(process.execPath, [path.join(__dirname, '..', 'bin', 'phewsh.js'), ...watchArgs], {
+          stdio: 'inherit',
+          detached: false,
+        });
+        child.on('error', (err) => {
+          console.log(`  ${ember('!')} ${sage('Watch failed:')} ${err.message}`);
+        });
+        // Store ref so we can clean up on exit
+        if (!global._phewshChildren) global._phewshChildren = [];
+        global._phewshChildren.push(child);
+        console.log(`\n  ${teal('●')} ${sage('Watch started — .intent/ syncing in background')}`);
+        console.log(`  ${slate('CLAUDE.md and cloud will auto-update on changes')}\n`);
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'serve') {
+        const { spawn } = require('child_process');
+        const serveArgs = ['serve'];
+        if (cmdArg) serveArgs.push(...cmdArg.split(/\s+/));
+        const child = spawn(process.execPath, [path.join(__dirname, '..', 'bin', 'phewsh.js'), ...serveArgs], {
+          stdio: 'inherit',
+          detached: false,
+        });
+        child.on('error', (err) => {
+          console.log(`  ${ember('!')} ${sage('Serve failed:')} ${err.message}`);
+        });
+        if (!global._phewshChildren) global._phewshChildren = [];
+        global._phewshChildren.push(child);
+        console.log(`\n  ${teal('●')} ${sage('Serve started — execution bridge running')}\n`);
+        rl.prompt();
+        return;
+      }
+
       if (cmd === 'run') {
         if (!cmdArg) {
           console.log(`  ${sage('Usage:')} ${cream('/run <prompt>')}`);
@@ -764,12 +781,7 @@ async function main() {
     // Regular input → send to AI
     if (!config?.apiKey) {
       console.log('');
-      console.log(`  ${peach('Almost there.')} ${sage('You need an API key to chat.')}`);
-      console.log(`  ${sage('Type')} ${cream('/key')} ${sage('and paste one in — takes 10 seconds.')}`);
-      console.log('');
-      console.log(`  ${slate('Get a key:')}  ${sage('console.anthropic.com/settings/keys')}`);
-      console.log(`  ${slate('Or try:')}     ${sage('openrouter.ai/keys')}`);
-      console.log(`  ${slate('Explore:')}    ${cream('/tour')} ${slate('to see what PHEWSH does (no key needed)')}`);
+      console.log(`  ${sage('Type')} ${cream('/key')} ${sage('to set your API key first.')}`);
       console.log('');
       rl.prompt();
       return;

package/lib/ui.js

@@ -11,8 +11,8 @@ const rgbBg = (r, g, b) => (s) => `\x1b[48;2;${r};${g};${b}m${s}\x1b[0m`;
 // Brand colors — relief, quiet, future
 const teal    = rgb(100, 215, 195);   // cool calm — primary
 const peach   = rgb(255, 195, 145);   // warm exhale — accent
-const sage    = rgb(130, 150, 140);   // quiet — secondary text
-const slate   = rgb(80, 90, 88);      // whisper — dim text
+const sage    = rgb(155, 175, 165);   // quiet — secondary text (bumped for readability)
+const slate   = rgb(105, 115, 112);   // whisper — dim text (bumped for readability)
 const cream   = rgb(240, 235, 225);   // clarity — bright text
 const ember   = rgb(220, 140, 90);    // glow — warnings/energy
 
@@ -227,14 +227,14 @@ function typewrite(text, speed = 25) {
 
 // ── Welcome tips ─────────────────────────────────────────
 const TIPS = [
-  `${slate('·')} ${cream('/clarify')} ${sage('turns a messy idea into .intent/ artifacts')}`,
-  `${slate('·')} ${cream('/gate')} ${sage('sets constraints — every AI response respects your budget and time')}`,
-  `${slate('·')} ${sage('Run')} ${cream('phewsh watch')} ${sage('in another tab — keeps CLAUDE.md in sync with .intent/')}`,
-  `${slate('·')} ${cream('/export')} ${sage('exports .intent/ as portable context for any AI tool')}`,
-  `${slate('·')} ${sage('.intent/ files are plain markdown — edit them directly anytime')}`,
-  `${slate('·')} ${cream('phewsh context --copy')} ${sage('puts your .intent/ context on the clipboard')}`,
-  `${slate('·')} ${cream('/tour')} ${sage('walks through the .intent/ workflow (no key needed)')}`,
-  `${slate('·')} ${sage('Everything works without an account. Account adds sync + sharing.')}`,
+  `${sage('try')} ${cream('/clarify')} ${sage('— turns ideas into .intent/ artifacts')}`,
+  `${sage('try')} ${cream('/gate')} ${sage('— set budget/time constraints, AI respects them')}`,
+  `${sage('try')} ${cream('/watch')} ${sage('— sync .intent/ to CLAUDE.md in the background')}`,
+  `${sage('try')} ${cream('/export')} ${sage('— .intent/ as portable context for any AI tool')}`,
+  `${sage('.intent/ is plain markdown — edit the files directly anytime')}`,
+  `${sage('the loop: define .intent/ → sync → work → evolve → repeat')}`,
+  `${sage('try')} ${cream('/tour')} ${sage('— quick walkthrough, no key needed')}`,
+  `${sage('works in Claude Code, Cursor, ChatGPT, and any MCP agent')}`,
 ];
 
 function randomTip() {
@@ -244,86 +244,69 @@ function randomTip() {
 // ── Tour content ─────────────────────────────────────────
 const TOUR_PAGES = [
   {
-    title: 'What is .intent/?',
+    title: 'The idea',
     body: [
       '',
-      `  ${teal('.intent/')} ${sage('is your project\'s working memory.')}`,
-      `  Plain markdown files, committed with your code, read by every AI tool.`,
+      `  Every AI tool you use asks the same question:`,
+      `  ${slate('"What are you building?"')}`,
       '',
-      `  ${cream('phew')} ${sage('— the relief of not re-explaining.')}`,
-      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
+      `  ${teal('.intent/')} ${sage('answers it once. Every tool reads it.')}`,
+      `  Plain markdown. Committed with your code. No lock-in.`,
       '',
-      `  PHEWSH is the tool that ${cream('authors')} and ${cream('syncs')} .intent/.`,
-      `  It works standalone, inside Claude Code, Cursor, ChatGPT, or any MCP agent.`,
-      '',
-      `  ${sage('You own these files. They travel with your code.')}`,
-      `  ${sage('Everything works without an account. Account adds sync + sharing.')}`,
+      `  ${sage('The loop:')} ${cream('define')} ${sage('→')} ${cream('sync')} ${sage('→')} ${cream('work')} ${sage('→')} ${cream('evolve')} ${sage('→')} ${cream('repeat')}`,
     ]
   },
   {
-    title: 'The .intent/ directory',
+    title: 'The files',
     body: [
       '',
       `  ${teal('.intent/')}`,
-      `    ${peach('vision.md')}    ${sage('What this project is and why it exists')}`,
+      `    ${peach('vision.md')}    ${sage('What you\'re building and why')}`,
       `    ${peach('plan.md')}      ${sage('Strategy, phases, milestones')}`,
-      `    ${peach('next.md')}      ${sage('Current tasks and what to do right now')}`,
-      `    ${ember('gate.json')}    ${sage('Your constraints (budget, time, skill)')}`,
+      `    ${peach('next.md')}      ${sage('What to do right now')}`,
+      `    ${ember('gate.json')}    ${sage('Constraints: budget, time, skill')}`,
       '',
-      `  ${sage('Create these with')} ${cream('/init')} ${sage('or')} ${cream('/clarify')}`,
+      `  ${cream('/init')} ${sage('creates them.')} ${cream('/clarify')} ${sage('authors them with AI.')}`,
+      `  ${sage('Or just edit the markdown directly.')}`,
     ]
   },
   {
-    title: 'Standalone mode',
+    title: 'Sync everywhere',
     body: [
       '',
-      `  Run ${cream('phewsh')} and type naturally.`,
-      `  Every message carries your .intent/ context automatically.`,
-      '',
-      `    ${teal('phewsh')} ${sage('>')} what should I focus on today?`,
-      `    ${teal('phewsh')} ${sage('>')} is my plan realistic given my budget?`,
-      `    ${teal('phewsh')} ${sage('>')} break this feature into tasks`,
-      '',
-      `  ${sage('The AI reads .intent/ — no warmup needed.')}`,
-    ]
-  },
-  {
-    title: '.intent/ in other tools',
-    body: [
+      `  ${cream('/watch')} ${sage('syncs .intent/ to your tools in the background:')}`,
       '',
-      `  ${b(cream('Claude Code'))}   ${sage('phewsh watch → CLAUDE.md stays in sync with .intent/')}`,
-      `  ${b(cream('Cursor'))}        ${sage('phewsh context --file → exports .intent/ to .phewsh.context')}`,
-      `  ${b(cream('ChatGPT'))}       ${sage('phewsh context --copy → .intent/ on your clipboard')}`,
-      `  ${b(cream('MCP agents'))}    ${sage('phewsh mcp setup → agents read .intent/ automatically')}`,
+      `  ${b(cream('Claude Code'))}   ${sage('→ CLAUDE.md auto-updates')}`,
+      `  ${b(cream('Cursor'))}        ${sage('→ /export writes .phewsh.context')}`,
+      `  ${b(cream('ChatGPT'))}       ${sage('→ /export --copy to clipboard')}`,
+      `  ${b(cream('MCP agents'))}    ${sage('→ self-brief from .intent/ via protocol')}`,
       '',
-      `  ${sage('Same .intent/. Every tool. Switch mid-thought. Nothing lost.')}`,
+      `  ${sage('Switch tools mid-thought. Context follows.')}`,
     ]
   },
   {
-    title: 'The Decision Gate',
+    title: 'Constraints',
     body: [
       '',
-      `  Before you build, decide ${b(cream('whether'))} to build.`,
-      `  The gate captures what you can actually spend:`,
+      `  ${cream('/gate')} ${sage('captures what you can actually spend:')}`,
       '',
       `    ${sage('Budget')}     ${cream('$50')}            ${sage('Skill')}      ${cream('expert')}`,
       `    ${sage('Time')}       ${cream('15 hrs/week')}     ${sage('Urgency')}    ${cream('high')}`,
       '',
-      `  ${sage('These constraints shape every AI response.')}`,
-      `  ${sage('Run')} ${cream('/gate activate')} ${sage('to set yours.')}`,
+      `  ${sage('Every AI response respects these.')}`,
+      `  ${sage('Ask "what should I do next?" — the answer fits your reality.')}`,
     ]
   },
   {
-    title: 'You\'re ready',
+    title: 'Go',
     body: [
       '',
-      `  ${teal('●')} ${cream('/init')} or ${cream('/clarify')} to create .intent/ artifacts`,
-      `  ${teal('●')} Type naturally — .intent/ context is always loaded`,
-      `  ${teal('●')} ${cream('/gate')} to set your constraints`,
-      `  ${teal('●')} ${cream('phewsh watch')} to keep AI tools in sync`,
-      `  ${teal('●')} ${cream('/help')} for all commands`,
+      `  ${teal('1.')} ${cream('/init')} ${sage('or')} ${cream('/clarify')} ${sage('— create .intent/')}`,
+      `  ${teal('2.')} ${sage('Type naturally — context is always loaded')}`,
+      `  ${teal('3.')} ${cream('/watch')} ${sage('— sync to all your tools')}`,
+      `  ${teal('4.')} ${cream('/gate')} ${sage('— set constraints')}`,
       '',
-      `  ${sage('.intent/ is your project\'s working memory. PHEWSH keeps it useful.')}`,
+      `  ${sage('Intent-driven development. Define once. Work everywhere.')}`,
     ]
   },
 ];

package/package.json

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