phewsh 0.11.12 → 0.11.13

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
@@ -80,21 +80,21 @@ function showHelp() {
   console.log(`  ${g('─'.repeat(48))}`);
   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')}          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('');
-  console.log(`  ${b(w('project'))}`);
-  console.log(`    ${cyan('intent')}    ${g('Manage .intent/ artifacts — status, open, evolve')}`);
+  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 portable context for any AI tool')}`);
-  console.log(`    ${cyan('ai')}        ${g('One-shot AI prompt with .intent/ context')}`);
+  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('');
   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(`    ${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('');
   console.log(`  ${b(w('connect'))}`);
   console.log(`    ${cyan('mcp')}       ${g('Connect AI agents via MCP protocol')}`);
@@ -105,7 +105,7 @@ function showHelp() {
   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('Everything works without an account. Account adds sync + sharing.')}`);
   console.log('');
 }
 

package/commands/session.js

@@ -213,7 +213,8 @@ 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(`  ${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('');
     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.')}`);

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

@@ -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')}`,
+  `${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.')}`,
 ];
 
 function randomTip() {
@@ -244,20 +244,20 @@ function randomTip() {
 // ── Tour content ─────────────────────────────────────────
 const TOUR_PAGES = [
   {
-    title: 'What is PHEWSH?',
+    title: 'What is .intent/?',
     body: [
       '',
-      `  ${cream('phew')} ${sage('— the relief of not starting from scratch.')}`,
-      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
+      `  ${teal('.intent/')} ${sage('is your project\'s working memory.')}`,
+      `  Plain markdown files, committed with your code, read by every AI tool.`,
       '',
-      `  PHEWSH gives your project a ${b(cream('portable identity'))}.`,
-      `  Define what you're building once — every AI tool reads it.`,
+      `  ${cream('phew')} ${sage('— the relief of not re-explaining.')}`,
+      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
       '',
-      `  It works ${cream('standalone')} as its own AI shell,`,
-      `  and ${cream('inside')} Claude Code, Cursor, ChatGPT, and any MCP agent.`,
+      `  PHEWSH is the tool that ${cream('authors')} and ${cream('syncs')} .intent/.`,
+      `  It works standalone, inside Claude Code, Cursor, ChatGPT, or any MCP agent.`,
       '',
-      `  ${sage('Your project context lives in')} ${teal('.intent/')} ${sage('— plain markdown.')}`,
-      `  ${sage('You own them. They travel with your code.')}`,
+      `  ${sage('You own these files. They travel with your code.')}`,
+      `  ${sage('Everything works without an account. Account adds sync + sharing.')}`,
     ]
   },
   {
@@ -278,26 +278,25 @@ const TOUR_PAGES = [
     body: [
       '',
       `  Run ${cream('phewsh')} and type naturally.`,
-      `  Every message carries your project's full context.`,
+      `  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 doesn\'t need a warmup. It already knows.')}`,
+      `  ${sage('The AI reads .intent/ — no warmup needed.')}`,
     ]
   },
   {
-    title: 'Inside other tools',
+    title: '.intent/ in other tools',
     body: [
       '',
-      `  ${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('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')}`,
       '',
-      `  ${sage('Same identity. Every tool. No re-explaining.')}`,
-      `  ${sage('Switch tools mid-thought. Nothing lost.')}`,
+      `  ${sage('Same .intent/. Every tool. Switch mid-thought. Nothing lost.')}`,
     ]
   },
   {
@@ -318,13 +317,13 @@ const TOUR_PAGES = [
     title: 'You\'re ready',
     body: [
       '',
-      `  ${teal('●')} Type naturally to chat with your project context`,
       `  ${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`,
       '',
-      `  ${sage('PHEWSH is your project\'s home base.')}`,
-      `  ${sage('The exhale before execution.')}`,
+      `  ${sage('.intent/ is your project\'s working memory. PHEWSH keeps it useful.')}`,
     ]
   },
 ];

package/package.json

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