paneful 0.7.3 → 0.8.1

package/README.md

@@ -2,6 +2,8 @@
 
 A terminal multiplexer that runs in your browser. Split panes, organize by project, drag and drop from Finder, sync with your editor — all from a single `npm install`.
 
+**Website:** [kplates.github.io/paneful](https://kplates.github.io/paneful/)
+
 ![Paneful](screenshot.png)
 
 ## Install
@@ -18,6 +20,8 @@ paneful --port 8080            # Use a specific port
 paneful --spawn                # Add current directory as a project
 paneful --list                 # List all projects
 paneful --kill my-project      # Kill a project by name
+paneful update                 # Update to the latest version
+paneful --install-app          # Install as a native macOS app
 ```
 
 ## Features
@@ -39,7 +43,8 @@ Save a workspace layout as a favourite — name, layout preset, and per-pane com
 Automatically switches the active project based on which editor window is in focus. Works with VS Code, Cursor, Zed, and Windsurf on macOS. Toggle via the monitor icon in the sidebar header.
 
 Requires:
-1. Terminal app added to **System Settings > Privacy & Security > Accessibility**
+
+1. **Paneful** (native app) or **Terminal** (CLI) added to **System Settings > Privacy & Security > Accessibility**
 2. Editor window title includes the folder name (default in VS Code/Cursor)
 
 ### Resizable Sidebar
@@ -50,24 +55,42 @@ Drag the right edge of the sidebar to resize it. Width persists across sessions.
 
 Press `Cmd+R` or click the dashboard icon in the toolbar to automatically pick the best layout for your current pane count.
 
+### Native macOS App
+
+Install Paneful as a standalone macOS app with its own Dock icon and window:
+
+```bash
+paneful --install-app
+```
+
+A folder picker dialog lets you choose the install location (defaults to `/Applications`). The app launches Paneful in a native WebKit window — no browser tab needed. Updating via `paneful update` automatically rebuilds the `.app` in place.
+
+### Updating
+
+```bash
+paneful update
+```
+
+Checks npm for the latest version, installs it globally, and rebuilds the native `.app` if one is installed. The Dock icon stays valid automatically.
+
 ### Update Notifications
 
 Paneful checks for newer versions on npm and shows a notification in the sidebar when an update is available.
 
 ## Keyboard Shortcuts
 
-| Shortcut          | Action                          |
-| ----------------- | ------------------------------- |
-| `Cmd+N`           | New pane (vertical split)       |
-| `Cmd+Shift+N`     | New pane (horizontal split)     |
-| `Cmd+W`           | Close focused pane              |
-| `Cmd+1-9`         | Focus pane by index             |
-| `Cmd+Arrow`       | Line start / end in terminal    |
-| `Ctrl+Shift+Arrow`| Move focus to adjacent pane     |
-| `Shift+Arrow`     | Swap focused pane with adjacent |
-| `Cmd+D`           | Toggle sidebar                  |
-| `Cmd+T`           | Cycle through layout presets    |
-| `Cmd+R`           | Auto reorganize panes           |
+| Shortcut           | Action                          |
+| ------------------ | ------------------------------- |
+| `Cmd+N`            | New pane (vertical split)       |
+| `Cmd+Shift+N`      | New pane (horizontal split)     |
+| `Cmd+W`            | Close focused pane              |
+| `Cmd+1-9`          | Focus pane by index             |
+| `Cmd+Arrow`        | Line start / end in terminal    |
+| `Ctrl+Shift+Arrow` | Move focus to adjacent pane     |
+| `Shift+Arrow`      | Swap focused pane with adjacent |
+| `Cmd+D`            | Toggle sidebar                  |
+| `Cmd+T`            | Cycle through layout presets    |
+| `Cmd+R`            | Auto reorganize panes           |
 
 ## Layout Presets
 

package/assets/icons/Contents.json

@@ -0,0 +1,318 @@
+{
+  "images": [
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "20x20",
+      "filename": "icon-ios-20x20@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "20x20",
+      "filename": "icon-ios-20x20@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "29x29",
+      "filename": "icon-ios-29x29@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "29x29",
+      "filename": "icon-ios-29x29@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "38x38",
+      "filename": "icon-ios-38x38@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "38x38",
+      "filename": "icon-ios-38x38@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "40x40",
+      "filename": "icon-ios-40x40@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "40x40",
+      "filename": "icon-ios-40x40@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "60x60",
+      "filename": "icon-ios-60x60@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "60x60",
+      "filename": "icon-ios-60x60@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "64x64",
+      "filename": "icon-ios-64x64@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "3x",
+      "size": "64x64",
+      "filename": "icon-ios-64x64@3x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "68x68",
+      "filename": "icon-ios-68x68@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "76x76",
+      "filename": "icon-ios-76x76@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "scale": "2x",
+      "size": "83.5x83.5",
+      "filename": "icon-ios-83.5x83.5@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "ios",
+      "size": "1024x1024",
+      "filename": "icon-ios-1024x1024.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "16x16",
+      "filename": "icon-mac-16x16.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "16x16",
+      "filename": "icon-mac-16x16@2x.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "32x32",
+      "filename": "icon-mac-32x32.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "32x32",
+      "filename": "icon-mac-32x32@2x.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "128x128",
+      "filename": "icon-mac-128x128.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "128x128",
+      "filename": "icon-mac-128x128@2x.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "256x256",
+      "filename": "icon-mac-256x256.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "256x256",
+      "filename": "icon-mac-256x256@2x.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "1x",
+      "size": "512x512",
+      "filename": "icon-mac-512x512.png"
+    },
+    {
+      "idiom": "mac",
+      "scale": "2x",
+      "size": "512x512",
+      "filename": "icon-mac-512x512@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "22x22",
+      "filename": "icon-watchos-22x22@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "24x24",
+      "filename": "icon-watchos-24x24@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "27.5x27.5",
+      "filename": "icon-watchos-27.5x27.5@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "29x29",
+      "filename": "icon-watchos-29x29@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "30x30",
+      "filename": "icon-watchos-30x30@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "32x32",
+      "filename": "icon-watchos-32x32@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "33x33",
+      "filename": "icon-watchos-33x33@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "40x40",
+      "filename": "icon-watchos-40x40@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "43.5x43.5",
+      "filename": "icon-watchos-43.5x43.5@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "44x44",
+      "filename": "icon-watchos-44x44@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "46x46",
+      "filename": "icon-watchos-46x46@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "50x50",
+      "filename": "icon-watchos-50x50@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "51x51",
+      "filename": "icon-watchos-51x51@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "54x54",
+      "filename": "icon-watchos-54x54@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "86x86",
+      "filename": "icon-watchos-86x86@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "98x98",
+      "filename": "icon-watchos-98x98@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "108x108",
+      "filename": "icon-watchos-108x108@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "117x117",
+      "filename": "icon-watchos-117x117@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "scale": "2x",
+      "size": "129x129",
+      "filename": "icon-watchos-129x129@2x.png"
+    },
+    {
+      "idiom": "universal",
+      "platform": "watchos",
+      "size": "1024x1024",
+      "filename": "icon-watchos-1024x1024.png"
+    }
+  ],
+  "info": {
+    "author": "makeappicon",
+    "version": 1
+  }
+}

package/dist/server/browser.js

@@ -58,20 +58,22 @@ export function openBrowser(port) {
 function tryChromeAppMode(url) {
     const appArg = `--app=${url}`;
     if (process.platform === 'darwin') {
+        // Use "open -na" to launch via macOS app framework — directly executing
+        // the binary is unreliable from .app bundles and can trigger the
+        // "choose application" dialog.
         const browsers = [
-            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-            '/Applications/Chromium.app/Contents/MacOS/Chromium',
-            '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-            '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
-            '/Applications/Arc.app/Contents/MacOS/Arc',
+            { app: 'Google Chrome', path: '/Applications/Google Chrome.app' },
+            { app: 'Chromium', path: '/Applications/Chromium.app' },
+            { app: 'Microsoft Edge', path: '/Applications/Microsoft Edge.app' },
+            { app: 'Brave Browser', path: '/Applications/Brave Browser.app' },
         ];
-        for (const browser of browsers) {
-            if (fs.existsSync(browser)) {
-                execFile(browser, [appArg], (err) => {
+        for (const { app, path: appPath } of browsers) {
+            if (fs.existsSync(appPath)) {
+                execFile('open', ['-na', app, '--args', appArg], (err) => {
                     if (err)
-                        console.warn(`Failed to launch ${browser}:`, err.message);
+                        console.warn(`Failed to launch ${app}:`, err.message);
                 });
-                console.log(`Opened in app mode via ${browser}`);
+                console.log(`Opened in app mode via ${app}`);
                 return true;
             }
         }

package/dist/server/index.js

@@ -37,6 +37,17 @@ async function getLatestVersion() {
         return null;
     }
 }
+function isNewerVersion(latest, current) {
+    const l = latest.split('.').map(Number);
+    const c = current.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] || 0) > (c[i] || 0))
+            return true;
+        if ((l[i] || 0) < (c[i] || 0))
+            return false;
+    }
+    return false;
+}
 // ── Paths ──
 function dataDir() {
     const dir = path.join(os.homedir(), '.paneful');
@@ -171,7 +182,7 @@ async function handleKill(name) {
 async function startServer(devMode, port) {
     // Lazy-load heavy dependencies (express, node-pty, ws, etc.)
     // so CLI commands that don't need the server start instantly
-    const [{ default: http }, { default: express }, { execFile }, { v4: uuidv4 }, { PtyManager }, { ProjectStore }, { WsHandler }, { startIpcListener },] = await Promise.all([
+    const [{ default: http }, { default: express }, { execFile }, { v4: uuidv4 }, { PtyManager }, { ProjectStore }, { WsHandler }, { startIpcListener }, { SettingsStore },] = await Promise.all([
         import('node:http'),
         import('express'),
         import('node:child_process'),
@@ -180,11 +191,13 @@ async function startServer(devMode, port) {
         import('./project-store.js'),
         import('./ws-handler.js'),
         import('./ipc.js'),
+        import('./settings-store.js'),
     ]);
     const app = express();
     app.use(express.json());
     const ptyManager = new PtyManager();
     const projectStore = new ProjectStore(dataDir());
+    const settingsStore = new SettingsStore(dataDir());
     // API routes
     app.get('/api/projects', (_req, res) => {
         res.json(projectStore.list());
@@ -205,6 +218,12 @@ async function startServer(devMode, port) {
         const latest = await getLatestVersion();
         res.json({ current: CURRENT_VERSION, latest });
     });
+    app.get('/api/settings', (_req, res) => {
+        res.json(settingsStore.get());
+    });
+    app.put('/api/settings', (req, res) => {
+        res.json(settingsStore.update(req.body));
+    });
     app.post('/api/projects/:id/kill', (req, res) => {
         const killed = ptyManager.killProject(req.params.id);
         res.json({ killed: killed.length });
@@ -272,6 +291,9 @@ async function startServer(devMode, port) {
                 else if (parts.length === 2) {
                     projectName = parts[0];
                 }
+                else {
+                    projectName = title;
+                }
             }
             const prev = editorCache.projectName;
             editorCache = { projectName };
@@ -367,7 +389,7 @@ async function startServer(devMode, port) {
     }
     const server = http.createServer(app);
     // WebSocket handler
-    const wsHandler = new WsHandler(server, ptyManager, projectStore);
+    const wsHandler = new WsHandler(server, ptyManager, projectStore, { onIdle: () => shutdown() });
     // IPC listener
     const ipcServer = startIpcListener(socketPath(), ptyManager, projectStore, wsHandler);
     server.on('error', (err) => {
@@ -383,18 +405,25 @@ async function startServer(devMode, port) {
         const actualPort = typeof addr === 'object' && addr ? addr.port : port;
         writeLockfile(process.pid, actualPort);
         console.log(`Paneful running on http://localhost:${actualPort}`);
-        if (!devMode) {
+        if (!devMode && !process.env.PANEFUL_APP) {
             openBrowser(actualPort);
         }
     });
     // Graceful shutdown
+    let shuttingDown = false;
     const shutdown = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
         console.log('Shutting down...');
         ptyManager.killAll();
         removeLockfile();
         ipcServer.close();
-        server.close();
-        process.exit(0);
+        server.close(() => {
+            process.exit(0);
+        });
+        // Force exit if server.close() hangs
+        setTimeout(() => process.exit(0), 2000);
     };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
@@ -406,13 +435,59 @@ program
     .option('--spawn', 'Spawn a new project in the current directory')
     .option('--list', 'List all projects')
     .option('--kill <name>', 'Kill a project by name')
-    .option('--install-app', 'Create Paneful.app in /Applications (macOS only)')
+    .option('--install-app', 'Create Paneful.app (macOS only)')
+    .option('--app-path <path>', 'Custom path for Paneful.app (default: /Applications/Paneful.app)')
     .option('--dev', 'Run in development mode (proxy to Vite dev server)')
-    .option('--port <number>', 'Port to listen on (default: random available)', parseInt)
-    .action(async (opts) => {
+    .option('--port <number>', 'Port to listen on (default: random)', parseInt);
+program
+    .command('update')
+    .description('Update paneful to the latest version')
+    .action(async () => {
+    const { execSync } = await import('node:child_process');
+    const latest = await getLatestVersion();
+    if (!latest) {
+        console.log('Could not check for updates. Try: npm install -g paneful@latest');
+        process.exit(1);
+    }
+    if (!isNewerVersion(latest, CURRENT_VERSION)) {
+        console.log(`Already on latest version (v${CURRENT_VERSION})`);
+        return;
+    }
+    console.log(`Updating paneful v${CURRENT_VERSION} → v${latest}...`);
+    execSync('npm install -g paneful@latest', { stdio: 'inherit' });
+    // Find existing Paneful.app to rebuild it in place
+    let appPath = null;
+    if (process.platform === 'darwin') {
+        try {
+            const found = execSync("mdfind \"kMDItemCFBundleIdentifier == 'com.paneful.app'\"", { encoding: 'utf-8' }).trim();
+            if (found)
+                appPath = found.split('\n')[0];
+        }
+        catch { /* spotlight unavailable */ }
+        // Fallback: check common locations
+        if (!appPath) {
+            for (const p of [
+                path.join(os.homedir(), 'Applications', 'Paneful.app'),
+                '/Applications/Paneful.app',
+            ]) {
+                if (fs.existsSync(p)) {
+                    appPath = p;
+                    break;
+                }
+            }
+        }
+    }
+    if (appPath) {
+        console.log(`\nRebuilding ${appPath}...`);
+        const { installApp } = await import('./install-app.js');
+        await installApp(appPath);
+    }
+    console.log('\nUpdate complete!');
+});
+program.action(async (opts) => {
     if (opts.installApp) {
         const { installApp } = await import('./install-app.js');
-        await installApp();
+        await installApp(opts.appPath);
         return;
     }
     if (opts.list) {
@@ -439,6 +514,6 @@ program
     if (lock) {
         removeLockfile();
     }
-    await startServer(opts.dev || false, opts.port || 56170);
+    await startServer(opts.dev || false, opts.port || 0);
 });
 program.parse();