hotsheet 0.2.0 → 0.2.1

package/README.md

@@ -12,15 +12,32 @@ No cloud. No logins. No JIRA. Just tickets and a tight feedback loop.
 
 <br>
 
+**Desktop app** (recommended) — download from [GitHub Releases](https://github.com/brianwestphal/hotsheet/releases):
+
+| Platform | Download |
+|----------|----------|
+| macOS (Apple Silicon) | `.dmg` (arm64) |
+| macOS (Intel) | `.dmg` (x64) |
+| Linux | `.AppImage` / `.deb` |
+| Windows | `.msi` / `.exe` |
+
+After installing, open the app and click **Install CLI** to add the `hotsheet` command to your PATH.
+
+**Or install via npm:**
+
 ```bash
 npm install -g hotsheet
 ```
 
+Then, from any project directory:
+
 ```bash
 hotsheet
 ```
 
-That's it. Opens in your browser. Data stays local.
+That's it. Data stays local.
+
+> **Note:** We're actively developing and testing on macOS. Linux and Windows builds are provided but less tested — if you run into issues on those platforms, we'd love your help! Please [open an issue](https://github.com/brianwestphal/hotsheet/issues).
 
 </div>
 
@@ -154,6 +171,28 @@ TICKET HS-15:
 
 ## Install
 
+### Desktop app (recommended)
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/brianwestphal/hotsheet/releases).
+
+On first launch, the app will prompt you to install the `hotsheet` CLI command. This creates a symlink so you can launch the desktop app from any project directory. You can also install it manually:
+
+**macOS:**
+```bash
+sudo ln -sf "/Applications/Hot Sheet.app/Contents/Resources/resources/hotsheet" /usr/local/bin/hotsheet
+```
+
+**Linux:**
+```bash
+ln -sf /path/to/hotsheet/resources/hotsheet-linux ~/.local/bin/hotsheet
+```
+
+The desktop app includes automatic updates — new versions are downloaded and applied in the background.
+
+### npm
+
+Alternatively, install via npm (runs in your browser instead of a native window):
+
 ```bash
 npm install -g hotsheet
 ```
@@ -165,14 +204,17 @@ Requires **Node.js 20+**.
 ## Usage
 
 ```bash
-# Start with defaults (port 4174, data in .hotsheet/)
+# Start from your project directory
 hotsheet
 
-# Custom port
+# Custom port (npm version only)
 hotsheet --port 8080
 
 # Custom data directory
 hotsheet --data-dir ~/projects/my-app/.hotsheet
+
+# Force browser mode (desktop app)
+hotsheet --browser
 ```
 
 ### Options
@@ -181,8 +223,21 @@ hotsheet --data-dir ~/projects/my-app/.hotsheet
 |------|-------------|
 | `--port <number>` | Port to run on (default: 4174) |
 | `--data-dir <path>` | Data directory (default: `.hotsheet/`) |
+| `--browser` | Open in browser instead of desktop window |
 | `--help` | Show help |
 
+### Customizing the window title
+
+When running multiple instances, you can customize the window title to tell them apart. Create `.hotsheet/settings.json` in your project:
+
+```json
+{
+  "appName": "HS - My Project"
+}
+```
+
+Without a settings file, the window title defaults to the project folder name.
+
 ### Keyboard shortcuts
 
 | Shortcut | Action |
@@ -206,6 +261,7 @@ hotsheet --data-dir ~/projects/my-app/.hotsheet
 
 | Layer | Technology |
 |-------|-----------|
+| Desktop | Tauri v2 (native window, auto-updates) |
 | CLI | TypeScript, Node.js |
 | Server | Hono |
 | Database | PGLite (embedded PostgreSQL) |

package/dist/cli.js

@@ -2044,7 +2044,7 @@ function tryServe(fetch, port2) {
     });
   });
 }
-async function startServer(port2, dataDir2) {
+async function startServer(port2, dataDir2, options) {
   const app = new Hono3();
   app.use("*", async (c, next) => {
     c.set("dataDir", dataDir2);
@@ -2068,8 +2068,17 @@ async function startServer(port2, dataDir2) {
       actualPort = await tryServe(app.fetch, port2 + attempt);
       break;
     } catch (err) {
-      if (err instanceof Error && err.code === "EADDRINUSE" && attempt < 19) {
-        continue;
+      if (err instanceof Error && err.code === "EADDRINUSE") {
+        if (options?.strictPort) {
+          console.error(`
+  Error: Port ${port2} is already in use.`);
+          console.error(`  In --strict-port mode, the server must start on the requested port`);
+          console.error(`  because the Tauri dev window is configured to connect to it.`);
+          console.error(`  Stop whatever is using port ${port2} and try again.
+`);
+          process.exit(1);
+        }
+        if (attempt < 19) continue;
       }
       throw err;
     }
@@ -2081,8 +2090,10 @@ async function startServer(port2, dataDir2) {
   console.log(`
   Hot Sheet running at ${url}
 `);
-  const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-  exec(`${openCmd} ${url}`);
+  if (!options?.noOpen) {
+    const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    exec(`${openCmd} ${url}`);
+  }
   return actualPort;
 }
 
@@ -2223,6 +2234,8 @@ function parseArgs(argv) {
   let dataDir2 = join7(process.cwd(), ".hotsheet");
   let demo = null;
   let forceUpdateCheck = false;
+  let noOpen = false;
+  let strictPort = false;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg.startsWith("--demo:")) {
@@ -2252,13 +2265,19 @@ function parseArgs(argv) {
       case "--check-for-updates":
         forceUpdateCheck = true;
         break;
+      case "--no-open":
+        noOpen = true;
+        break;
+      case "--strict-port":
+        strictPort = true;
+        break;
       default:
         console.error(`Unknown option: ${arg}`);
         printUsage();
         process.exit(1);
     }
   }
-  return { port: port2, dataDir: dataDir2, demo, forceUpdateCheck };
+  return { port: port2, dataDir: dataDir2, demo, forceUpdateCheck, noOpen, strictPort };
 }
 async function main() {
   const parsed = parseArgs(process.argv);
@@ -2266,7 +2285,7 @@ async function main() {
     printUsage();
     process.exit(1);
   }
-  const { port: port2, demo, forceUpdateCheck } = parsed;
+  const { port: port2, demo, forceUpdateCheck, noOpen, strictPort } = parsed;
   let { dataDir: dataDir2 } = parsed;
   await checkForUpdates(forceUpdateCheck);
   if (demo !== null) {
@@ -2297,7 +2316,7 @@ async function main() {
     await cleanupAttachments();
   }
   console.log(`  Data directory: ${dataDir2}`);
-  const actualPort = await startServer(port2, dataDir2);
+  const actualPort = await startServer(port2, dataDir2, { noOpen, strictPort });
   initMarkdownSync(dataDir2, actualPort);
   scheduleAllSync();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotsheet",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A lightweight local project management tool. Create, categorize, and prioritize tickets with a fast bullet-list interface, then export an Up Next worklist for AI tools.",
   "type": "module",
   "license": "MIT",
@@ -33,8 +33,13 @@
     "build:client": "mkdir -p dist/client && npx esbuild src/client/app.ts --bundle --format=iife --outfile=dist/client/app.global.js --target=es2020 --jsx=automatic --jsx-import-source=#jsx --alias:#jsx/jsx-runtime=./src/jsx-runtime.ts && npx sass src/client/styles.scss dist/client/styles.css --style compressed --no-source-map",
     "lint": "eslint src/",
     "clean": "rm -rf dist node_modules/.cache",
+    "tauri:clean": "rm -rf src-tauri/target",
     "release": "bash scripts/release.sh",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "dev:server": "npm run build:client && tsx --tsconfig tsconfig.json src/cli.ts --no-open --strict-port",
+    "tauri": "tauri",
+    "tauri:dev": "bash scripts/ensure-sidecar-stub.sh && tauri dev",
+    "tauri:build": "bash scripts/build-sidecar.sh && tauri build"
   },
   "files": [
     "dist",
@@ -57,6 +62,7 @@
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
+    "@tauri-apps/cli": "^2",
     "typescript-eslint": "^8.56.1"
   }
 }