pi-deck 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# Pi-Deck
+
+A web interface for [Pi](https://github.com/badlogic/pi-mono), the terminal coding agent. This is a personal project I built for my own workflow — it lets me use Pi from a browser instead of the terminal, with multi-workspace support so I can manage several projects at once.
+
+> **Note:** This is personal tooling, not a general-purpose product. It works for my setup and I make no guarantees about stability, compatibility, or support. Feel free to fork or take ideas from it.
+
+## Features
+
+- **Multi-workspace tabs** — open multiple project directories side by side
+- **Real-time streaming** — chat with Pi via WebSocket, see responses as they arrive
+- **Tool visualization** — watch tool calls execute with live output
+- **Thinking blocks** — collapsible display for reasoning model internals
+- **Session management** — switch between sessions, pick models per workspace
+- **Image support** — paste or drag images into prompts
+- **Persistent state** — open workspaces, theme, and drafts sync across devices via SQLite
+- **Directory allowlist** — control which directories are accessible from the UI
+
+## Stack
+
+- **Frontend:** React 19, Vite, TailwindCSS
+- **Backend:** Express, WebSocket, Pi SDK
+- **Storage:** SQLite for UI state
+
+## Install from npm
+
+```bash
+npm install -g pi-deck
+pi-deck
+```
+
+Or run without installing:
+
+```bash
+npx pi-deck
+```
+
+Requires Node.js 20+ and an API key configured (e.g. `ANTHROPIC_API_KEY`).
+
+Open `http://localhost:9741` in your browser.
+
+### CLI options
+
+```
+pi-deck                # start the server on port 9741
+pi-deck --port 8080    # use a custom port
+pi-deck --build        # rebuild before starting (for local dev)
+pi-deck --help         # show all options
+```
+
+## Development setup
+
+Clone the repo and install dependencies:
+
+```bash
+git clone https://github.com/user/pi-deck.git
+cd pi-deck
+npm install
+```
+
+### Dev mode (hot-reload)
+
+```bash
+npm run dev       # frontend on :9740, backend on :9741
+```
+
+### Production mode (no hot-reload)
+
+```bash
+npm run build     # build everything
+npm start         # start the server on :9741
+```
+
+### Local CLI
+
+To use the `pi-deck` command from your local checkout:
+
+```bash
+npm run build
+npm link          # creates a global 'pi-deck' symlink
+pi-deck           # works from any directory
+```
+
+To remove: `npm unlink -g pi-deck`
+
+## Publishing to npm
+
+```bash
+npm run build     # builds shared → server → client → bundles server with esbuild
+npm pack          # creates a .tgz to inspect before publishing
+npm publish       # publish to the npm registry
+```
+
+The published package includes a bundled server (`dist/server.js`) and the pre-built client SPA (`packages/client/dist/`). Workspace dependencies are inlined by esbuild; only runtime dependencies (`express`, `better-sqlite3`, etc.) are installed by npm.
+
+## Configuration
+
+Create a config file at `~/.config/pi-deck/config.json`:
+
+```json
+{
+  "port": 9741,
+  "host": "0.0.0.0",
+  "allowedDirectories": ["~/projects", "~/code"]
+}
+```
+
+Or use environment variables: `PORT`, `HOST`, `PI_ALLOWED_DIRS` (colon-separated).
+
+## Running as a service
+
+I run this on a Mac mini with Tailscale for always-on access from any device.
+
+```bash
+npm run service:install    # install as launchd service (starts on login)
+npm run service:uninstall  # remove it
+```
+
+Logs go to `~/Library/Logs/pi-deck/`.
+
+## License
+
+MIT

package/bin/pi-deck.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join, resolve } from 'path';
+import { existsSync } from 'fs';
+import { execSync, fork } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = resolve(__dirname, '..');
+
+const bundledServer = join(ROOT, 'dist/server.js');
+const clientDist = join(ROOT, 'packages/client/dist');
+
+// Parse CLI flags
+const args = process.argv.slice(2);
+const helpFlag = args.includes('--help') || args.includes('-h');
+const buildFlag = args.includes('--build');
+const portFlag = args.indexOf('--port');
+const portValue = portFlag !== -1 ? args[portFlag + 1] : undefined;
+
+if (helpFlag) {
+  console.log(`
+  pi-deck - Start the Pi-Deck server
+
+  Usage:
+    pi-deck [options]
+
+  Options:
+    --build       Build before starting (if not already built)
+    --port <n>    Override server port (default: 9741)
+    -h, --help    Show this help message
+
+  The server will serve the built client UI and expose the WebSocket API.
+  Run 'npm run build' in the project root first, or use --build.
+`);
+  process.exit(0);
+}
+
+// Check if build exists, offer to build if not
+const serverBuilt = existsSync(bundledServer);
+const clientBuilt = existsSync(clientDist);
+
+if (!serverBuilt || !clientBuilt) {
+  if (buildFlag) {
+    console.log('[pi-deck] Building project...');
+    try {
+      execSync('npm run build', { cwd: ROOT, stdio: 'inherit' });
+    } catch {
+      console.error('[pi-deck] Build failed. Fix errors and retry.');
+      process.exit(1);
+    }
+  } else {
+    if (!serverBuilt) console.error(`[pi-deck] Server not built. Missing: ${bundledServer}`);
+    if (!clientBuilt) console.error(`[pi-deck] Client not built. Missing: ${clientDist}`);
+    console.error('[pi-deck] Run "npm run build" first, or use "pi-deck --build".');
+    process.exit(1);
+  }
+}
+
+// Set port via env if provided
+if (portValue) {
+  process.env.PORT = portValue;
+}
+
+// Tell the bundled server where the client dist lives
+process.env.PI_DECK_CLIENT_DIST = clientDist;
+
+// Start the server
+console.log('[pi-deck] Starting Pi-Deck server...');
+const child = fork(bundledServer, [], {
+  cwd: ROOT,
+  stdio: 'inherit',
+  env: { ...process.env },
+});
+
+child.on('exit', (code) => {
+  process.exit(code ?? 0);
+});
+
+// Forward signals for clean shutdown
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => {
+    child.kill(sig);
+  });
+}