beecork 1.3.7 → 1.3.9

package/README.md

@@ -24,8 +24,8 @@ Message Claude Code from Telegram at 2am — it wakes up, does the work, message
 - **Virtual tabs** — Persistent Claude Code sessions with context that survives restarts.
 - **Task scheduling** — Tell Claude Code to set up recurring tasks via MCP tools — it wakes up, runs the task, reports back.
 - **Memory** — Cross-session memory so Claude Code never loses context.
-- **MCP server** — 38 tools Claude Code can call to manage tabs, memory, cron jobs, watchers, media, projects, and more.
-- **Smart routing** — Pipe brain routes messages to the right tab, tracks goals, learns from your usage.
+- **MCP server** — 38 tools Claude Code can call to manage tabs, memory, cron jobs, watchers, media, folders, and more.
+- **Smart routing** — Pipe brain routes messages to the right folder and tab, tracks goals, learns from your usage.
 - **Background service** — Runs as a launchd (macOS), systemd (Linux), or Task Scheduler (Windows) service. Starts on login, runs silently.
 
 ## Quick Start
@@ -89,7 +89,7 @@ beecork mcp list           # List MCP server configs
 beecork media setup        # Configure media generators
 beecork activity           # View activity summary
 beecork history            # Show activity timeline
-beecork projects           # List discovered projects
+beecork folders            # List discovered folders
 beecork machines           # List registered machines
 beecork templates          # List tab templates
 beecork store search <q>   # Search community extensions

package/dist/channels/command-handler.js

@@ -147,44 +147,46 @@ export async function handleSharedCommand(ctx, tabManager) {
         }).join('\n\n');
         return { handled: true, response: `🖥 ${machines.length} machine(s):\n\n${list}` };
     }
-    // /projects
-    if (text === '/projects' || text.startsWith('/projects@')) {
+    // /folders (also accept legacy /projects)
+    if (text === '/folders' || text === '/projects' || text.startsWith('/folders@') || text.startsWith('/projects@')) {
         const { listProjects } = await import('../projects/index.js');
         const projects = listProjects();
         if (projects.length === 0)
-            return { handled: true, response: 'No projects found. Create one with /newproject <name>' };
+            return { handled: true, response: 'No folders found. Create one with /newfolder <name>' };
         const userProjects = projects.filter((p) => p.type === 'user-project');
         const categories = projects.filter((p) => p.type === 'category');
-        let msg = '📦 Projects:\n';
+        let msg = '📁 Folders:\n';
         if (userProjects.length > 0)
             msg += userProjects.map((p) => `  • ${p.name} — ${p.path}`).join('\n');
         if (categories.length > 0) {
-            msg += '\n\n📁 Categories:\n';
+            msg += '\n\n📂 Categories:\n';
             msg += categories.map((p) => `  • ${p.name}`).join('\n');
         }
         return { handled: true, response: msg };
     }
-    // /project <name>
-    if (text.startsWith('/project ') && !text.startsWith('/projects')) {
-        const name = text.slice(9).trim();
+    // /folder <name> (also accept legacy /project <name>)
+    if ((text.startsWith('/folder ') && !text.startsWith('/folders')) || (text.startsWith('/project ') && !text.startsWith('/projects'))) {
+        const prefix = text.startsWith('/folder ') ? '/folder ' : '/project ';
+        const name = text.slice(prefix.length).trim();
         const { getProject, setUserContext } = await import('../projects/index.js');
         const project = getProject(name);
         if (!project)
-            return { handled: true, response: `Project "${name}" not found. Use /projects to list or /newproject to create.` };
+            return { handled: true, response: `Folder "${name}" not found. Use /folders to list or /newfolder to create.` };
         setUserContext(userId, project.name, project.name);
-        return { handled: true, response: `Switched to project: ${project.name}\nPath: ${project.path}\n\nNext messages will work in this project.` };
+        return { handled: true, response: `Switched to folder: ${project.name}\nPath: ${project.path}\n\nNext messages will work in this folder.` };
     }
-    // /newproject <name> [path]
-    if (text.startsWith('/newproject ')) {
-        const parts = text.slice(12).trim().split(/\s+/);
+    // /newfolder <name> [path] (also accept legacy /newproject)
+    if (text.startsWith('/newfolder ') || text.startsWith('/newproject ')) {
+        const prefix = text.startsWith('/newfolder ') ? '/newfolder ' : '/newproject ';
+        const parts = text.slice(prefix.length).trim().split(/\s+/);
         const name = parts[0];
         const customPath = parts[1] || undefined;
         if (!name)
-            return { handled: true, response: 'Usage: /newproject <name> [path]' };
+            return { handled: true, response: 'Usage: /newfolder <name> [path]' };
         const { createProject, setUserContext } = await import('../projects/index.js');
         const project = createProject(name, customPath);
         setUserContext(userId, project.name, project.name);
-        return { handled: true, response: `✓ Project "${name}" created at ${project.path}\nSwitched to this project.` };
+        return { handled: true, response: `✓ Folder "${name}" created at ${project.path}\nSwitched to this folder.` };
     }
     // /close <tab>
     if (text.startsWith('/close ')) {
@@ -197,16 +199,16 @@ export async function handleSharedCommand(ctx, tabManager) {
         const closed = closeTab(tabNameToClose);
         return { handled: true, response: closed ? `Tab "${tabNameToClose}" permanently closed. History deleted.` : `Tab "${tabNameToClose}" not found.` };
     }
-    // /fresh <project>
+    // /fresh <folder>
     if (text.startsWith('/fresh ')) {
-        const projectName = text.slice(7).trim();
+        const folderName = text.slice(7).trim();
         const { getProject, setUserContext } = await import('../projects/index.js');
-        const project = getProject(projectName);
+        const project = getProject(folderName);
         if (!project)
-            return { handled: true, response: `Project "${projectName}" not found.` };
-        const freshTabName = `${projectName}-${Date.now().toString(36).slice(-4)}`;
+            return { handled: true, response: `Folder "${folderName}" not found.` };
+        const freshTabName = `${folderName}-${Date.now().toString(36).slice(-4)}`;
         setUserContext(userId, project.name, freshTabName);
-        return { handled: true, response: `Fresh start in "${projectName}" (tab: ${freshTabName})\nSend your message now.` };
+        return { handled: true, response: `Fresh start in "${folderName}" (tab: ${freshTabName})\nSend your message now.` };
     }
     return { handled: false };
 }

package/dist/cli/setup.js

@@ -202,9 +202,9 @@ export async function setupWizard() {
         console.log('    beecork dashboard  — open web control panel');
         console.log('    beecork quickstart — full getting-started checklist');
         console.log('');
-        console.log('  ★ Recommended: Smart project routing');
-        console.log('    If you work on multiple projects, Beecork can auto-detect which');
-        console.log('    project you mean and route messages to the right tab.');
+        console.log('  ★ Recommended: Smart folder routing');
+        console.log('    If you work in multiple folders, Beecork can auto-detect which');
+        console.log('    folder you mean and route messages to the right tab.');
         console.log('    Run: beecork pipe setup');
         console.log('');
         console.log('  Add more channels:');

package/dist/index.js

@@ -170,8 +170,8 @@ program
     const ask = (q, def) => new Promise(r => rl.question(def ? `${q} [${def}]: ` : `${q}: `, a => r(a.trim() || def || '')));
     console.log('\nWhatsApp Setup\n');
     console.log('  WhatsApp connects via QR code scanning (like WhatsApp Web).');
-    console.log('  When you start the daemon, a QR code will appear in the terminal.');
-    console.log('  Scan it with your phone to link.\n');
+    console.log('  After setup, run "beecork start" and the QR code will appear');
+    console.log('  in your terminal. Scan it with your phone to pair.\n');
     const number = await ask('Your WhatsApp phone number (e.g., 14155551234)');
     if (!number) {
         console.log('No number provided. Cancelled.');
@@ -188,7 +188,10 @@ program
         allowedNumbers: [number],
     };
     saveConfig(config);
-    console.log('\n✓ WhatsApp configured. Restart daemon to scan QR: beecork stop && beecork start\n');
+    console.log('\n✓ WhatsApp configured.');
+    console.log('  Next: run "beecork start" — the QR code will appear in your terminal.');
+    console.log('  Scan it with your phone to pair. Once paired, press Ctrl+C and');
+    console.log('  run "beecork start" again for background operation.\n');
     rl.close();
 });
 program
@@ -394,18 +397,19 @@ program
     console.log('');
 });
 program
-    .command('projects')
-    .description('List all discovered projects')
+    .command('folders')
+    .alias('projects')
+    .description('List all discovered folders')
     .action(async () => {
     const { listProjects } = await import('./projects/index.js');
     const projects = listProjects();
     if (projects.length === 0) {
-        console.log('No projects found. Start the daemon to discover projects.');
+        console.log('No folders found. Start the daemon to discover folders.');
         return;
     }
-    console.log(`\n${projects.length} project(s):\n`);
+    console.log(`\n${projects.length} folder(s):\n`);
     for (const p of projects) {
-        const icon = p.type === 'category' ? '📁' : '📦';
+        const icon = p.type === 'category' ? '📂' : '📁';
         console.log(`  ${icon} ${p.name} — ${p.path}`);
     }
     console.log('');

package/dist/mcp/server.js

@@ -81,7 +81,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 type: 'object',
                 properties: {
                     content: { type: 'string', description: 'The fact or information to remember' },
-                    scope: { type: 'string', enum: ['global', 'project', 'tab', 'auto'], description: 'Where to store: global (about the user), project (about this project), tab (about this conversation), or auto (Claude decides)' },
+                    scope: { type: 'string', enum: ['global', 'project', 'tab', 'auto'], description: 'Where to store: global (about the user), project (about this folder), tab (about this conversation), or auto (Claude decides)' },
                     category: { type: 'string', description: 'For global scope: people, preferences, routines, or general' },
                 },
                 required: ['content'],
@@ -324,7 +324,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'beecork_machines',
-            description: 'List registered machines and their project paths. Shows which machine handles which projects.',
+            description: 'List registered machines and their folder paths. Shows which machine handles which folders.',
             inputSchema: { type: 'object', properties: {} },
         },
         {
@@ -352,11 +352,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'beecork_project_create',
-            description: 'Create a new project folder in the workspace',
+            description: 'Register a new folder in the workspace',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    name: { type: 'string', description: 'Project name' },
+                    name: { type: 'string', description: 'Folder name' },
                     path: { type: 'string', description: 'Optional: custom path. Defaults to workspace root.' },
                 },
                 required: ['name'],
@@ -364,7 +364,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'beecork_project_list',
-            description: 'List all known projects and categories',
+            description: 'List all known folders and categories',
             inputSchema: { type: 'object', properties: {} },
         },
         {
@@ -425,11 +425,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'beecork_knowledge',
-            description: 'List all knowledge Beecork has about the current context (global + project + tab)',
+            description: 'List all knowledge Beecork has about the current context (global + folder + tab)',
             inputSchema: {
                 type: 'object',
                 properties: {
-                    scope: { type: 'string', enum: ['global', 'project', 'tab', 'all'], description: 'Which layer to show (default: all)' },
+                    scope: { type: 'string', enum: ['global', 'project', 'tab', 'all'], description: 'Which layer to show: global, project (folder), tab, or all (default: all)' },
                 },
             },
         },
@@ -793,13 +793,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { name, path: customPath } = args;
                 const { createProject } = await import('../projects/index.js');
                 const project = createProject(name, customPath);
-                return ok(`Project "${name}" created at ${project.path}`);
+                return ok(`Folder "${name}" registered at ${project.path}`);
             }
             case 'beecork_project_list': {
                 const { listProjects } = await import('../projects/index.js');
                 const projects = listProjects();
                 if (projects.length === 0)
-                    return ok('No projects discovered. Create one with beecork_project_create.');
+                    return ok('No folders discovered. Create one with beecork_project_create.');
                 const lines = projects.map(p => `${p.type === 'category' ? '📁' : '📦'} ${p.name} — ${p.path}`);
                 return ok(lines.join('\n'));
             }

package/dist/pipe/brain.js

@@ -25,13 +25,13 @@ export class PipeBrain {
         const route = await this.route(message, decisions);
         // Step 2: Ensure the tab exists with the right working directory
         if (route.projectPath) {
-            this.tabManager.ensureTab(route.tabName);
+            this.tabManager.ensureTab(route.tabName, route.projectPath);
             this.memory.updateProjectLastUsed(route.projectPath);
         }
         // Step 3: Send to Claude Code
         let result;
         try {
-            result = await this.tabManager.sendMessage(route.tabName, message, { skipExtraction: true });
+            result = await this.tabManager.sendMessage(route.tabName, message, { skipExtraction: true, projectPath: route.projectPath ?? undefined });
         }
         catch (err) {
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beecork",
-  "version": "1.3.7",
+  "version": "1.3.9",
   "description": "Claude Code always-on infrastructure — a phone number, a memory, and an alarm clock",
   "type": "module",
   "bin": {