frizz 0.13.10 → 0.13.12

package/README.md

@@ -27,22 +27,20 @@ Frizz is for you if you have any of these opinions:
 
 **Requirements.** Node 22.13+, and a [Claude Code](https://claude.com/claude-code) or [Codex](https://developers.openai.com/codex) subscription you are signed in to — Frizz drives the subscription you already pay for. Frizz brings its own pinned copy of each CLI (downloaded once, on first start), so the version on your PATH is yours to manage and never changes what a thread runs.
 
-Then run it in any directory — a repo, a jj checkout, or a folder of scripts. Frizz has no opinion about version control and does not require Git.
+Then run it, from anywhere.
 
 ```sh
-$ cd path/to/acme
 $ npx frizz
 
   FRIZZ v0.4.0  ready in 4.0s
 
-  ➜  Local:    http://127.0.0.1:9393/project/acme/
-  ➜  Project:  acme — path/to/acme
+  ➜  Local:    http://127.0.0.1:9393/
   ➜  Logs:     ~/Library/Application Support/Frizz/projects/979dae3c-fe15-4038-817e-11d0e7491959/logs/frizz-2026-08-01T13-44-43-16931.log
 
   press ctrl-c to stop · run with --debug for the full event feed
 ```
 
-A browser tab opens at `http://127.0.0.1:9393/project/acme/`. Frizz always listens on port 9393 (19393 if something else holds it), and one server serves every project on the machine. Each directory you run it in becomes a **project** with its own board at `/project/<name>`, so running `npx frizz` in a second repo registers that project and opens its board in the server already running rather than starting another. Runs on macOS, Linux, and Windows.
+A browser tab opens on the dashboard at `http://127.0.0.1:9393/`. Add a **project** there — any folder: a repo, a jj checkout, or a folder of scripts. Frizz has no opinion about version control and does not require Git. Each project gets its own board at `/project/<name>`, and from then on running `npx frizz` inside that folder opens its board. Frizz always listens on port 9393 (19393 if something else holds it), and one server serves every project on the machine, so a second run joins the server already running rather than starting another. Runs on macOS, Linux, and Windows.
 
 <p align="center">
   <img src="assets/board.png" alt="The Frizz board: the project rail down the left, the composer and the queue of threads beside it, and on the right a card where an agent is asking an answerable question with numbered options drawn as keycaps, with its snooze clock and done check in the card's header." width="100%">
@@ -67,7 +65,7 @@ Frizz is a browser tab, a queue, and the agent CLIs you already pay for. It brin
 
 ### Projects
 
-Every directory you run `npx frizz` in becomes a project with its own board, all served by the one Frizz on your machine. The home page at `http://127.0.0.1:9393/` lists them.
+Every folder you add becomes a project with its own board, all served by the one Frizz on your machine. The dashboard at `http://127.0.0.1:9393/` lists them, and it is where `npx frizz` lands when it is run outside one.
 
 <p align="center">
   <img src="assets/projects.png" alt="The Frizz home page: a rail of project icons down the left, and four project cards — design-system, acme-web, acme-api, frizz — each with its home-relative path and when it was last opened, plus an Add a project card." width="100%">
@@ -134,10 +132,11 @@ Frizz production launcher
 
 Usage: npx frizz [options]
 
-Run it in the directory you want to work in. One server serves EVERY project on this machine,
-each at its own /project/<name> URL, so a second run joins the one already going. Runs the
-npm-resolved immutable Frizz package, then opens it in your default browser. Use frizz-dev only
-for a source checkout.
+Run it anywhere. One server serves EVERY project on this machine, each at its own
+/project/<name> URL, so a second run joins the one already going. In a folder that is already a
+project it opens that project's board; anywhere else it opens the dashboard, where projects are
+added. Runs the npm-resolved immutable Frizz package, then opens it in your default browser. Use
+frizz-dev only for a source checkout.
 
 Options:
   --no-app               print the URL without opening a browser

package/dist/frizz.js

@@ -862,11 +862,6 @@ import { dirname as dirname2, isAbsolute as isAbsolute2, join as join3, relative
 function legacyFrizzRoot(home = homedir2()) {
   return join3(home, LEGACY_DIR_NAME);
 }
-function isLegacyStateRoot(root, exists) {
-  if (!exists(root)) return false;
-  if (!exists(join3(root, ".id")) && !exists(join3(root, ".gitignore"))) return true;
-  return exists(join3(root, "projects")) || exists(join3(root, "registry.json"));
-}
 function xdg(env, name) {
   const value = env[name];
   return value && (value.startsWith("/") || /^[A-Za-z]:[\\/]/u.test(value)) ? value : void 0;
@@ -909,7 +904,7 @@ function frizzPaths(options2 = {}) {
   const home = options2.home ?? homedir2();
   const exists = options2.exists ?? existsSync2;
   const legacyRoot = legacyFrizzRoot(home);
-  if (isLegacyStateRoot(legacyRoot, exists)) {
+  if (exists(legacyRoot)) {
     return { data: legacyRoot, state: legacyRoot, cache: legacyRoot, legacy: true };
   }
   const explicit = {
@@ -931,6 +926,9 @@ function frizzRoots() {
 function projectStateDir(projectId, home) {
   return join3(home ? frizzPaths({ home }).data : frizzRoots().data, "projects", projectId);
 }
+function launchHostDir(home) {
+  return join3(home ? frizzPaths({ home }).data : frizzRoots().data, "host");
+}
 var LEGACY_DIR_NAME, cached;
 var init_frizz_paths = __esm({
   "packages/server/src/frizz-paths.ts"() {
@@ -13641,7 +13639,7 @@ var init_src = __esm({
       "running",
       // process alive, turn in flight
       "perm-prompt",
-      // process alive, paused on an interactive permission prompt (answer in the terminal)
+      // process alive, parked on a permission request a person has not answered yet
       "turn-idle",
       // process alive, waiting at the prompt
       "exited"
@@ -21105,13 +21103,6 @@ function isHomeDirectory(dir, home = homedir8()) {
     return false;
   }
 }
-function isStateRootHome(dir, home = homedir8()) {
-  return isHomeDirectory(dir, home) && frizzPaths({ home }).legacy;
-}
-function refuseStateRootHome(dir, home = homedir8()) {
-  if (isStateRootHome(dir, home))
-    throw new Error("Frizz keeps its own files in ~/.frizz on this machine, so the home folder cannot be a project here \u2014 choose a folder inside it.");
-}
 function isWorldWritable(dir, platform = process.platform) {
   if (platform === "win32") return false;
   try {
@@ -21148,7 +21139,7 @@ function discoverProjectRoot(cwd = process.cwd(), home = homedir8()) {
   const stop = resolve3(home);
   const filesystemRoot = parse(dir).root;
   for (let at = dir; ; at = dirname8(at)) {
-    if (at === stop || at === filesystemRoot || isHomeDirectory(at, home)) break;
+    if (at === stop || at === filesystemRoot) break;
     if (existsSync4(projectIdPath(at))) return at;
     if (hasAny(at, REPO_MARKERS)) return at;
     if (hasAny(at, PROJECT_MARKERS)) return at;
@@ -21160,7 +21151,6 @@ var FRIZZ_DIR, ID_FILE, SELF_IGNORE, REPO_MARKERS, PROJECT_MARKERS;
 var init_project_root = __esm({
   "packages/server/src/project-root.ts"() {
     "use strict";
-    init_frizz_paths();
     init_project_identity();
     FRIZZ_DIR = ".frizz";
     ID_FILE = ".id";
@@ -21269,6 +21259,7 @@ function canonicalPath(dir) {
 }
 function registerProject(input, home = homedir9()) {
   input = { ...input, dir: canonicalPath(input.dir) };
+  if (input.dir === canonicalPath(launchHostDir(home))) return { action: "unlisted" };
   const registry = readRegistry(home);
   if (registry.forgotten) {
     registry.forgotten = registry.forgotten.filter((id) => id !== input.id);
@@ -25467,6 +25458,7 @@ init_boot_progress();
 init_frizz_paths();
 import { execFileSync as execFileSync3 } from "node:child_process";
 import { createServer as createServer2 } from "node:net";
+import { randomUUID as randomUUID5 } from "node:crypto";
 import { existsSync as existsSync6, mkdirSync as mkdirSync10, mkdtempSync, readdirSync as readdirSync3, readFileSync as readFileSync10, realpathSync as realpathSync5, rmSync as rmSync8, symlinkSync as symlinkSync2, writeFileSync as writeFileSync10 } from "node:fs";
 import { homedir as homedir10, tmpdir as tmpdir2 } from "node:os";
 import { basename as basename5, dirname as dirname10, join as join13, resolve as resolve4 } from "node:path";
@@ -25606,6 +25598,7 @@ function prepareSandbox(env = process.env, realHome = homedir10()) {
   } catch {
     throw new Error("--sandbox mints a throwaway git repository and git is not available \u2014 install git, or play in a repo of your own with a temp HOME");
   }
+  writeProjectIdFile(project, randomUUID5());
   process.chdir(project);
   return { home, project };
 }
@@ -25646,26 +25639,26 @@ function cleanupSandbox(home) {
   } catch {
   }
 }
-function emptyLaunchMessage(intent) {
-  return intent.reason === "home" ? "Frizz keeps its own files in ~/.frizz on this machine, so it cannot open your home directory as a project, and there is no other project to show yet. cd into another folder and run frizz there." : `A folder every account can write to cannot be a project: ${intent.directory}. Run frizz in a folder only you can write to.`;
-}
 function resolveLaunchIntent(cwd = process.cwd(), home = homedir10(), env = process.env) {
   const candidate = realpathSync5(discoverProjectRoot(cwd, home));
   const known = isExistingProjectRoot(candidate) || findByPath(candidate, home) !== void 0;
-  const isHome = isHomeDirectory(candidate, home);
-  const refused = isWorldWritable(candidate) ? "world-writable" : isStateRootHome(candidate, home) ? "home" : void 0;
-  if (!refused && (known || hasProjectMarker(candidate) && !isHome))
-    return { kind: "open", workspace: resolveWorkspace(cwd, home, env) };
-  const host = mostRecentProject(home, env);
-  if (!host) {
-    if (refused) return { kind: "empty", directory: candidate, reason: refused };
-    return { kind: "open", workspace: resolveWorkspace(cwd, home, env) };
-  }
-  return refused || isHome ? { kind: "grid", workspace: host } : { kind: "offer", workspace: host, directory: candidate };
+  const refused = isHomeDirectory(candidate, home) || isWorldWritable(candidate);
+  if (known && !refused) return { kind: "open", workspace: resolveWorkspace(cwd, home, env) };
+  const host = mostRecentProject(home, env) ?? hostWorkspace(home);
+  return !refused && hasProjectMarker(candidate) ? { kind: "offer", workspace: host, directory: candidate } : { kind: "grid", workspace: host };
+}
+function hostWorkspace(home = homedir10()) {
+  const dir = launchHostDir(home);
+  mkdirSync10(dir, { recursive: true });
+  const root = realpathSync5(dir);
+  const id = ensureProjectIdFile(root, home);
+  const stateDir = projectStateDir(id, home);
+  mkdirSync10(stateDir, { recursive: true });
+  return { root, id, stateDir, name: basename5(root), identityScope: "repository" };
 }
 function mostRecentProject(home, env) {
   for (const entry of listProjects(home)) {
-    if (entry.stale || isStateRootHome(entry.path, home) || isWorldWritable(entry.path)) continue;
+    if (entry.stale || isHomeDirectory(entry.path, home) || isWorldWritable(entry.path)) continue;
     try {
       return resolveWorkspace(entry.path, home, env);
     } catch {
@@ -25689,7 +25682,6 @@ function resolveWorkspace(cwd = process.cwd(), home = homedir10(), env = process
   }
   const root0 = realpathSync5(gitRoot ?? discoverProjectRoot(cwd, home));
   refuseWorldWritableProject(root0);
-  refuseStateRootHome(root0, home);
   const identity = gitRoot ? resolveGitProjectIdentity(root0, home) : void 0;
   const root = identity?.root ?? root0;
   const id = ensureProjectIdFile(root, home, identity?.id);
@@ -26019,7 +26011,7 @@ init_restart_supervisor();
 init_logging();
 init_boot_progress();
 import { fork } from "node:child_process";
-import { randomUUID as randomUUID5 } from "node:crypto";
+import { randomUUID as randomUUID6 } from "node:crypto";
 import { existsSync as existsSync7, mkdirSync as mkdirSync11, readFileSync as readFileSync11 } from "node:fs";
 import { createServer as createNetServer } from "node:net";
 import { basename as basename6, dirname as dirname11, extname as extname2, isAbsolute as isAbsolute4, relative as relative2, resolve as resolve5, sep as sep3 } from "node:path";
@@ -26264,7 +26256,7 @@ var Supervisor = class {
   watchSubscribe;
   reexec;
   supervisorLock;
-  statusPublisherToken = randomUUID5();
+  statusPublisherToken = randomUUID6();
   processGeneration = currentProcessGeneration();
   ownerToken;
   launchTarget;
@@ -27220,7 +27212,7 @@ var npmRegistryReleaseAdapter = createNpmRegistryReleaseAdapter();
 // src/server-release.ts
 init_frizz_paths();
 import { execFile as execFile4 } from "node:child_process";
-import { createHash as createHash4, randomUUID as randomUUID6 } from "node:crypto";
+import { createHash as createHash4, randomUUID as randomUUID7 } from "node:crypto";
 import {
   closeSync as closeSync5,
   existsSync as existsSync9,
@@ -27376,7 +27368,7 @@ function npmServerPackageInstaller(env = process.env) {
 }
 function atomicJson2(path, value) {
   mkdirSync12(dirname13(path), { recursive: true, mode: 448 });
-  const temp = `${path}.${randomUUID6()}.tmp`;
+  const temp = `${path}.${randomUUID7()}.tmp`;
   try {
     const fd = openSync6(temp, "wx", 384);
     try {
@@ -27477,7 +27469,7 @@ var ServerReleaseStore = class {
     const spec = { ...this.spec, version };
     assertSpec(spec, this.compatibility);
     mkdirSync12(this.generations, { recursive: true, mode: 448 });
-    const id = randomUUID6();
+    const id = randomUUID7();
     const staging = join15(this.generations, `${id}.staging`);
     const destination = join15(this.generations, id);
     mkdirSync12(staging, { mode: 448 });
@@ -27503,7 +27495,7 @@ var ServerReleaseStore = class {
 // src/server-owner.ts
 init_frizz_paths();
 init_project_launch();
-import { randomUUID as randomUUID7 } from "node:crypto";
+import { randomUUID as randomUUID8 } from "node:crypto";
 import { mkdirSync as mkdirSync13, readFileSync as readFileSync13, realpathSync as realpathSync7 } from "node:fs";
 import { join as join16 } from "node:path";
 var STABLE_SERVER_OWNER_NAME = "frizz-server";
@@ -27548,7 +27540,7 @@ function wrapLease(lease) {
     token: lease.token,
     pid: lease.pid,
     processStart: lease.processStart,
-    publisherToken: randomUUID7()
+    publisherToken: randomUUID8()
   };
 }
 function acquireStableServerOwner(roots) {
@@ -27679,10 +27671,11 @@ if (options.help) {
 
 Usage: npx ${PACKAGE_NAME} [options]
 
-Run it in the directory you want to work in. One server serves EVERY project on this machine,
-each at its own /project/<name> URL, so a second run joins the one already going. Runs the
-npm-resolved immutable Frizz package, then opens it in your default browser. Use frizz-dev only
-for a source checkout.
+Run it anywhere. One server serves EVERY project on this machine, each at its own
+/project/<name> URL, so a second run joins the one already going. In a folder that is already a
+project it opens that project's board; anywhere else it opens the dashboard, where projects are
+added. Runs the npm-resolved immutable Frizz package, then opens it in your default browser. Use
+frizz-dev only for a source checkout.
 
 Options:
   --no-app               print the URL without opening a browser
@@ -27733,7 +27726,6 @@ var workspace = (() => {
       return workspaceFromLaunchTarget(pinned);
     }
     const intent = resolveLaunchIntent();
-    if (intent.kind === "empty") throw new Error(emptyLaunchMessage(intent));
     launchIntent = intent;
     return intent.workspace;
   } catch (error) {
@@ -27879,7 +27871,7 @@ async function openOrPrint(port, reused, path = "") {
   if (sandbox) warnings.push(`Sandbox: everything here is throwaway (${sandbox.home}) and is deleted when this terminal closes.`);
   if (sessionNotice && !reused) warnings.push(sessionNotice);
   if (!readout) {
-    console.log(`${reused ? "reusing" : "started"} Frizz for ${workspace.root}`);
+    console.log(`${reused ? "reusing" : "started"} Frizz${launchIntent && launchIntent.kind !== "open" ? "" : ` for ${workspace.root}`}`);
     console.log(url);
     if (publicOrigin) console.log(activeAccessLink?.url ?? `${publicOrigin}/`);
     for (const warning of warnings) console.log(warning);
@@ -27890,7 +27882,9 @@ async function openOrPrint(port, reused, path = "") {
     [
       { label: "Local", value: boardAddress(url), accent: true },
       ...publicOrigin ? [{ label: "Public", value: activeAccessLink?.url ?? `${publicOrigin}/`, accent: true }] : [],
-      { label: "Project", value: `${workspace.name} \u2014 ${tildePath(workspace.root, home)}` },
+      // Only an `open` launch is ABOUT its workspace; any other is hosted on a project the operator
+      // did not pick (launcher.ts resolveLaunchIntent), and naming it here reads as "you opened this".
+      ...launchIntent && launchIntent.kind !== "open" ? [] : [{ label: "Project", value: `${workspace.name} \u2014 ${tildePath(workspace.root, home)}` }],
       ...logger.file ? [{ label: "Logs", value: tildePath(logger.file, home) }] : []
     ],
     reused ? (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frizz",
-  "version": "0.13.10",
+  "version": "0.13.12",
   "private": false,
   "description": "A local web UI for running many coding agents at once",
   "keywords": [
@@ -66,7 +66,7 @@
   },
   "frizzServer": {
     "package": "frizz-server",
-    "version": "0.15.20",
+    "version": "0.15.22",
     "protocol": 1,
     "dataEpoch": 1
   }