phewsh 0.11.12 → 0.11.14

package/bin/phewsh.js

@@ -30,7 +30,7 @@ function showBrand() {
   console.log('');
   console.log(`  ${b(w('█▀█ █░█ █▀▀ █░█ █▀ █░█'))}`);
   console.log(`  ${b(w('█▀▀ █▀█ ██▄ ▀▄▀ ▄█ █▀█'))}`);
-  console.log(`  ${g('Your project identity for every AI tool.')}`);
+  console.log(`  ${g('.intent/ — your project\'s working memory for every AI tool.')}`);
   console.log('');
 
   // Context-aware hint
@@ -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 — type naturally, get guided`);
-  console.log(`    ${cyan('phewsh clarify')}   Turn a messy idea into a structured spec`);
-  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('project'))}`);
-  console.log(`    ${cyan('intent')}    ${g('Manage .intent/ artifacts — status, open, evolve')}`);
-  console.log(`    ${cyan('gate')}      ${g('Declare constraints (budget, time, skill, urgency)')}`);
-  console.log(`    ${cyan('context')}   ${g('Export portable context for any AI tool')}`);
-  console.log(`    ${cyan('ai')}        ${g('One-shot AI prompt with .intent/ context')}`);
+  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('push')}      ${g('Push .intent/ to cloud')}`);
-  console.log(`    ${cyan('pull')}      ${g('Pull from cloud to .intent/')}`);
-  console.log(`    ${cyan('watch')}     ${g('Live sync — CLAUDE.md + web dashboard auto-update')}`);
-  console.log(`    ${cyan('serve')}     ${g('Execution bridge for the web app')}`);
+  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('Works standalone · Inside Claude Code · Inside Cursor · With any MCP agent')}`);
+  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,23 +212,11 @@ async function main() {
 
   // ── First-run welcome ──────────────────────────────────
   if (!config?.apiKey) {
-    console.log(`  ${b(cream('Welcome.'))}`);
-    console.log(`  ${sage('Your AI already knows your project. 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.')}`);
@@ -237,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),
@@ -260,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({
@@ -307,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;
@@ -716,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>')}`);
@@ -763,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/commands/watch.js

@@ -2,7 +2,7 @@
 //
 // Watches .intent/ for changes and auto-pushes to Supabase + regenerates CLAUDE.md.
 // This is the backbone of cross-tool continuity:
-//   edit in terminal → web dashboard updates → Claude Code knows.
+//   edit in terminal → phewsh.com/intent updates → Claude Code knows.
 //
 // Usage:
 //   phewsh watch              Start watching (push + CLAUDE.md)
@@ -85,8 +85,8 @@ function generateClaudeSection() {
   const decisionGate = gate || projectJson?.decisionGate;
 
   sections.push(`# PHEWSH Adaptive Context — ${projectName}`);
+  sections.push(`> **Generated file. Do not edit.** Modify .intent/ instead — this section regenerates automatically.`);
   sections.push(`> Auto-synced by \`phewsh watch\` | ${new Date().toISOString().split('T')[0]}`);
-  sections.push(`> This section is regenerated on every .intent/ change. Do not edit manually.`);
   sections.push('');
 
   // Project identity
@@ -318,25 +318,25 @@ function watchIntent() {
 
 function showHelp() {
   console.log(`
-  phewsh watch — Live .intent/ sync daemon
+  phewsh watch — Keep AI tools in sync with .intent/
 
   Usage:
     phewsh watch              Start watching
     phewsh watch --no-claude  Skip CLAUDE.md regeneration
-    phewsh watch --no-push    Skip cloud push (local CLAUDE.md only)
+    phewsh watch --no-push    Skip cloud push (local only)
     phewsh watch --verbose    Show detailed sync info
 
   What it does:
     Watches .intent/ for changes and automatically:
-    1. Pushes updated artifacts to Supabase (web dashboard updates live)
-    2. Regenerates the PHEWSH section in CLAUDE.md (Claude Code stays current)
+    1. Regenerates CLAUDE.md so Claude Code stays current with .intent/
+    2. Pushes to phewsh.com/intent (optional — needs account)
 
-    This creates the cross-tool continuity loop:
-      edit gate in terminal -> web dashboard reorganizes -> Claude already knows
+    The loop:
+      edit .intent/ → CLAUDE.md updates → cloud mirror updates → every tool knows
 
   Requirements:
     - .intent/ directory must exist (run \`phewsh intent --init\`)
-    - \`phewsh login\` for cloud push (optional — CLAUDE.md works without it)
+    - Everything works without an account. Account adds cloud sync.
   `);
 }
 
@@ -352,8 +352,8 @@ async function main() {
   const loggedIn = !!config?.supabaseUserId;
 
   console.log('');
-  console.log(`  ${b(w('PHEWSH Watch'))} ${g('v' + require('../package.json').version)}`);
-  console.log(`  ${g('Live .intent/ sync — cross-tool continuity')}`);
+  console.log(`  ${b(w('.intent/ Watch'))} ${g('v' + require('../package.json').version)}`);
+  console.log(`  ${g('Keeps your AI tools in sync with .intent/')}`);
   console.log('');
 
   // Show what's enabled
@@ -361,7 +361,7 @@ async function main() {
   if (!flags.noClaude) features.push(`${green('●')} CLAUDE.md auto-sync`);
   else features.push(`${g('○')} CLAUDE.md ${g('(disabled)')}`);
 
-  if (!flags.noPush && loggedIn) features.push(`${green('●')} Cloud push (web dashboard)`);
+  if (!flags.noPush && loggedIn) features.push(`${green('●')} Cloud push → phewsh.com/intent`);
   else if (!flags.noPush && !loggedIn) features.push(`${yellow('●')} Cloud push ${g('(not logged in — run phewsh login)')}`);
   else features.push(`${g('○')} Cloud push ${g('(disabled)')}`);
 

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
 
@@ -150,7 +150,7 @@ async function brandReveal(fast = false) {
   await sleep(100);
 
   // Phase 5: Tagline fades in — dim → sage → cream
-  const tagline = 'relief. quiet execution.';
+  const tagline = '.intent/ is your project\'s working memory.';
   process.stdout.write(`  ${slate(tagline)}`);
   await sleep(200);
   process.stdout.write(`${clearLine}  ${sage(tagline)}`);
@@ -227,14 +227,14 @@ function typewrite(text, speed = 25) {
 
 // ── Welcome tips ─────────────────────────────────────────
 const TIPS = [
-  `${slate('·')} ${sage('Type')} ${cream('/clarify')} ${sage('to turn a messy idea into a structured spec')}`,
-  `${slate('·')} ${cream('/gate')} ${sage('sets budget, time, and skill constraints — AI respects them')}`,
-  `${slate('·')} ${sage('Run')} ${cream('phewsh watch')} ${sage('in another tab for live sync to CLAUDE.md')}`,
-  `${slate('·')} ${cream('/export')} ${sage('creates a portable context file for any AI tool')}`,
-  `${slate('·')} ${cream('/model opus')} ${sage('for complex reasoning,')} ${cream('/model haiku')} ${sage('for speed')}`,
-  `${slate('·')} ${sage('Your')} ${cream('.intent/')} ${sage('files are plain markdown — edit them anytime')}`,
-  `${slate('·')} ${cream('phewsh context --copy')} ${sage('puts your project context on the clipboard')}`,
-  `${slate('·')} ${cream('/tour')} ${sage('walks you through everything PHEWSH can do')}`,
+  `${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,87 +244,69 @@ function randomTip() {
 // ── Tour content ─────────────────────────────────────────
 const TOUR_PAGES = [
   {
-    title: 'What is PHEWSH?',
+    title: 'The idea',
     body: [
       '',
-      `  ${cream('phew')} ${sage('— the relief of not starting from scratch.')}`,
-      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
+      `  Every AI tool you use asks the same question:`,
+      `  ${slate('"What are you building?"')}`,
       '',
-      `  PHEWSH gives your project a ${b(cream('portable identity'))}.`,
-      `  Define what you're building once — every AI tool reads it.`,
+      `  ${teal('.intent/')} ${sage('answers it once. Every tool reads it.')}`,
+      `  Plain markdown. Committed with your code. No lock-in.`,
       '',
-      `  It works ${cream('standalone')} as its own AI shell,`,
-      `  and ${cream('inside')} Claude Code, Cursor, ChatGPT, and any MCP agent.`,
-      '',
-      `  ${sage('Your project context lives in')} ${teal('.intent/')} ${sage('— plain markdown.')}`,
-      `  ${sage('You own them. They travel with your code.')}`,
+      `  ${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 project's full context.`,
-      '',
-      `    ${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 doesn\'t need a warmup. It already knows.')}`,
-    ]
-  },
-  {
-    title: 'Inside other tools',
-    body: [
+      `  ${cream('/watch')} ${sage('syncs .intent/ to your tools in the background:')}`,
       '',
-      `  ${b(cream('Claude Code'))}   ${sage('phewsh watch → auto-updates CLAUDE.md')}`,
-      `  ${b(cream('Cursor'))}        ${sage('phewsh context --file → .phewsh.context')}`,
-      `  ${b(cream('ChatGPT'))}       ${sage('phewsh context --copy → paste in')}`,
-      `  ${b(cream('MCP agents'))}    ${sage('phewsh mcp setup → agents self-brief')}`,
+      `  ${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 identity. Every tool. No re-explaining.')}`,
-      `  ${sage('Switch tools 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('●')} Type naturally to chat with your project context`,
-      `  ${teal('●')} ${cream('/init')} or ${cream('/clarify')} to create .intent/ artifacts`,
-      `  ${teal('●')} ${cream('/gate')} to set your constraints`,
-      `  ${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('PHEWSH is your project\'s home base.')}`,
-      `  ${sage('The exhale before execution.')}`,
+      `  ${sage('Intent-driven development. Define once. Work everywhere.')}`,
     ]
   },
 ];

package/package.json

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