frizz 0.13.9 → 0.13.11

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
@@ -254,7 +253,7 @@ Frizz has its own small vocabulary. Most of it names a feature, so this doubles
 | **Snooze** | Hide a card until later — an hour, tomorrow morning, or a date you pick — optionally with a follow-up prompt attached. |
 | **Goal** | A standing prompt a thread receives on its own — every time it rests, on a clock, or both — until you switch it off or the agent says it's done. |
 | **Scratchpad** | A thread's durable working memory, readable under its **Doc** tab. Where a worker keeps what a summary would otherwise lose: the approach, the alternatives it rejected, the decisions you made and reversed. |
-| **`FRIZZ.md`** | An optional file at your repo root whose contents are injected into every thread, for when you want agents to follow your repo's own norms. Only agents Frizz starts read it. A project with no threads and no `FRIZZ.md` opens on a short questionnaire — how agents land work, how independently they act, anything else they should know — that writes one for you. |
+| **`FRIZZ.md`** | An optional file at your repo root whose contents are injected into every thread, for when you want agents to follow your repo's own norms. Only agents Frizz starts read it. |
 
 <br/>
 
@@ -267,7 +266,7 @@ Frizz has its own small vocabulary. Most of it names a feature, so this doubles
 
 <h2 align="center">Contributing</h2>
 
-Issues and pull requests are welcome. Fork the repo, branch off `main`, and open the PR against `main` — CI runs on every pull request.
+Issues and pull requests are welcome. Fork the repo, branch off `main`, and open the PR against `main` — CI runs on every pull request. Keep **Allow edits by maintainers** checked (GitHub offers it only on forks in a personal account, not an organization), so a follow-up commit from the maintainer can land in your PR rather than separately on `main`.
 
 Three checks run in CI, and they need no install:
 

package/dist/frizz.js

@@ -926,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"() {
@@ -13275,31 +13278,6 @@ var init_drainable_worker = __esm({
   }
 });
 
-// packages/shared/src/frizz-md.ts
-var FrizzMdLanding, FrizzMdAutonomy, FRIZZ_MD_NOTES_MAX, FrizzMdAnswers, FrizzMdStatus;
-var init_frizz_md = __esm({
-  "packages/shared/src/frizz-md.ts"() {
-    "use strict";
-    init_zod();
-    FrizzMdLanding = external_exports.enum(["pull-request", "main", "main-push", "branch"]);
-    FrizzMdAutonomy = external_exports.enum(["decide", "balanced", "check-in"]);
-    FRIZZ_MD_NOTES_MAX = 8e3;
-    FrizzMdAnswers = external_exports.object({
-      landing: FrizzMdLanding,
-      autonomy: FrizzMdAutonomy,
-      notes: external_exports.string().max(FRIZZ_MD_NOTES_MAX)
-    }).strict();
-    FrizzMdStatus = external_exports.object({
-      /** A FRIZZ.md is already at the project root: the project has its rules, so nothing is asked. */
-      exists: external_exports.boolean(),
-      /** The operator skipped the questionnaire for this project: it is not asked again. */
-      skipped: external_exports.boolean(),
-      /** The branch the landing rules name — the remote's default, else the checked-out one, else `main`. */
-      defaultBranch: external_exports.string()
-    });
-  }
-});
-
 // packages/shared/src/receipt-bus.ts
 var init_receipt_bus = __esm({
   "packages/shared/src/receipt-bus.ts"() {
@@ -13547,7 +13525,7 @@ function requireEffortOutsideAcp(profile, ctx) {
 function fallbackPort(base) {
   return base + 1e4;
 }
-var import_yaml, ATTACHMENT_IMAGE_EXTENSIONS, ATTACHMENT_TEXT_EXTENSIONS, ATTACHMENT_OFFICE_EXTENSIONS, ATTACHMENT_DATA_EXTENSIONS, ATTACHMENT_ARCHIVE_EXTENSIONS, ATTACHMENT_DOC_EXTENSIONS, ATTACHMENT_EXTENSIONS, ATTACHMENT_MAX_BASE64_CHARS, ATTACHMENT_MAX_BYTES, ATTACHMENT_EXT_SET, ATTACHMENT_ACCEPT, FrizzStatus, BlockMechanism, RuntimeState, Backend, CodexModel, ClaudeModel, AcpAgent, AcpAgentModel, AcpAgentModels, AcpAgentModelsInput, ThreadProfileOption, ThreadAgent, SubAgentView, BgShellView, CompletionHoldOp, CompletionHold, AskOption, AskQuestion, PendingAsk, AwaitingHint, RETIRED_AWAITING_KINDS, RETIRED_LINE_RE, AWAITING_FOR_MAX_MS, SnoozeUntil, SNOOZE_PROMPT_MAX, SnoozePrompt, RECURRING_PROMPT_MAX, RECURRING_MIN_INTERVAL_SECONDS, RECURRING_MAX_INTERVAL_SECONDS, RecurringPromptText, RecurringIntervalSeconds, ThreadRecurringPrompt, TIMER_PROMPT_MAX, TIMER_MAX_DELAY_SECONDS, TimerPromptText, SIGNOFF_NUDGE_MARKER, SIGNOFF_NUDGE_MESSAGE, SIGNOFF_NUDGE_MESSAGE_NEEDS_INPUT, ThreadWatchKind, GithubChecksState, GithubMergeState, GithubWatchStatus, GithubIssueStatus, ThreadWatchView, PR_WATCH_FOR_MAX_MS, PR_WATCH_DEFAULT_FOR_MS, PrWatchView, AddOwnPrWatchInput, AddOwnPrWatchResult, DropOwnPrWatchInput, DropOwnPrWatchResult, OwnWatchKind, AddOwnWatchInput, OwnWatchView, AddOwnWatchResult, DropOwnWatchInput, DropOwnWatchResult, AskQuestionKind, AskedOptionSchema, AskedQuestionSchema, AskInput, RegisteredQuestionView, SECRET_TTL_MS, AskResult, UnaskInput, UnaskResult, QuestionAnswerSchema, AnswerQuestionsInput, AnswerQuestionsResult, DismissQuestionsInput, DismissQuestionsResult, SettledQuestionView, ThreadSettledQuestionsResult, MarkOwnDoneInput, MarkOwnDoneResult, ListOwnPrWatchesInput, OwnPrWatchesResult, ThreadTimerView, ThreadFence, LimitWindow, LimitPause, ProviderError, ThreadLinkView, UpsertOwnLinkInput, UpsertOwnLinkResult, DropOwnLinkInput, DropOwnLinkResult, LiveTool, ThreadView, BoardErrorItem, BoardSnapshot, QuotaWindow, ProviderQuota, QuotaSnapshot, ProviderAuth, AccountEmails, AuthSnapshot, AccountBackend, AccountLogoutInput, AccountLogoutResult, PermissionMode, LocalFileOpener, Settings, DispatchProviderPreferences, DispatchPreferences, DispatchProfileSnapshotShape, DispatchProfileSnapshot, SetDispatchPreferenceInput, DispatchInput, ADOPT_THREAD_MESSAGE_MAX_CHARS, AdoptThreadInput, AdoptThreadResult, AdoptSessionInput, FollowUpInput, DismissFailedFollowUpInput, DismissFailedFollowUpResult, UnqueueFollowUpInput, UnqueueFollowUpResult, DeliverQueuedNowInput, DeliverQueuedNowResult, CompactThreadInput, SetThreadSnoozeInput, SetThreadPinnedInput, SetThreadRecurringPromptInput, SetOwnThreadRecurringPromptInput, SetOwnThreadRecurringPromptResult, GetOwnThreadRecurringPromptInput, OwnThreadRecurringPromptResult, SetOwnThreadTimerInput, CancelOwnThreadTimerInput, ListOwnThreadTimersInput, OwnThreadTimersResult, ThreadActivityItem, ListOwnThreadActivityInput, OwnThreadActivityResult, SetOwnThreadTimerResult, CancelOwnThreadTimerResult, SetOwnThreadStopHookInput, SetOwnThreadHeartbeatInput, ThreadPluginReloadResult, RenameThreadInput, AiRenameThreadInput, AiRenameThreadResult, SetOwnThreadTitleInput, SetOwnThreadTitleResult, SetThreadPermissionInput, SetThreadPermissionResult, ThreadProfileOptionsInput, ThreadProfileOptionsResult, ThreadSkillSource, ThreadSkill, ThreadSkillsInput, ThreadSkillsResult, SetThreadProfileInput, SetThreadProfileResult, UpgradeThreadModelInput, UpgradeThreadModelResult, DISPATCH_TASK_BANNER, DISPATCH_TASK_BANNER_MARKER, HUMAN_GAP_FLOOR_MS, GithubWakeItem, GithubWakeSteer, WAKE_SCOPE, WAKE_REF, WAKE_SINGLE, WAKE_MULTI_HEAD, PR_WATCH_FINISHED, PR_WATCH_CI_PASSED, PR_WATCH_CI_GATED, PR_WATCH_STATE, PR_WATCH_CI_FAILED, GithubStatus, GithubRefCard, GithubRefPreviewInput, GithubRefPreviewResult, GithubItem, GithubListInput, GithubListResult, GithubBatchInput, GithubBatchResult, BoardMeta, ServerEvent, TranscriptEdit, TranscriptTodo, TranscriptToolCall, TranscriptPart, TranscriptMessage, TranscriptPageCursor, EditedFile, TranscriptPage, TranscriptEarlierInput, SocketTranscriptSlug, SocketFilePath, SocketTranscriptClientMsg, SocketFileClientMsg, SocketClientMsg, ProjectCard, ProjectRailCounts, PROJECT_ICON_MAX_BASE64_CHARS, DirectoryPickResult, ThreadLocation, FRIZZ_ROUTE_PREFIX, DEFAULT_PORT;
+var import_yaml, ATTACHMENT_IMAGE_EXTENSIONS, ATTACHMENT_TEXT_EXTENSIONS, ATTACHMENT_OFFICE_EXTENSIONS, ATTACHMENT_DATA_EXTENSIONS, ATTACHMENT_ARCHIVE_EXTENSIONS, ATTACHMENT_DOC_EXTENSIONS, ATTACHMENT_EXTENSIONS, ATTACHMENT_MAX_BASE64_CHARS, ATTACHMENT_MAX_BYTES, ATTACHMENT_EXT_SET, ATTACHMENT_ACCEPT, FrizzStatus, BlockMechanism, RuntimeState, Backend, CodexModel, ClaudeModel, AcpAgent, AcpAgentModel, AcpAgentModels, AcpAgentModelsInput, ThreadProfileOption, ThreadAgent, SubAgentView, BgShellView, CompletionHoldOp, CompletionHold, AskOption, AskQuestion, PendingAsk, AwaitingHint, RETIRED_AWAITING_KINDS, RETIRED_LINE_RE, AWAITING_FOR_MAX_MS, SnoozeUntil, SNOOZE_PROMPT_MAX, SnoozePrompt, RECURRING_PROMPT_MAX, RECURRING_MIN_INTERVAL_SECONDS, RECURRING_MAX_INTERVAL_SECONDS, RecurringPromptText, RecurringIntervalSeconds, ThreadRecurringPrompt, TIMER_PROMPT_MAX, TIMER_MAX_DELAY_SECONDS, TimerPromptText, SIGNOFF_NUDGE_MARKER, SIGNOFF_NUDGE_MESSAGE, SIGNOFF_NUDGE_MESSAGE_NEEDS_INPUT, ThreadWatchKind, GithubChecksState, GithubMergeState, GithubWatchStatus, GithubIssueStatus, ThreadWatchView, PR_WATCH_FOR_MAX_MS, PR_WATCH_DEFAULT_FOR_MS, PrWatchView, AddOwnPrWatchInput, AddOwnPrWatchResult, DropOwnPrWatchInput, DropOwnPrWatchResult, OwnWatchKind, AddOwnWatchInput, OwnWatchView, AddOwnWatchResult, DropOwnWatchInput, DropOwnWatchResult, AskQuestionKind, AskedOptionSchema, AskedQuestionSchema, AskInput, RegisteredQuestionView, SECRET_TTL_MS, AskResult, UnaskInput, UnaskResult, QuestionAnswerSchema, AnswerQuestionsInput, AnswerQuestionsResult, DismissQuestionsInput, DismissQuestionsResult, SettledQuestionView, ThreadSettledQuestionsResult, MarkOwnDoneInput, MarkOwnDoneResult, ListOwnPrWatchesInput, OwnPrWatchesResult, ThreadTimerView, ThreadFence, LimitWindow, LimitPause, ProviderError, ThreadLinkView, UpsertOwnLinkInput, UpsertOwnLinkResult, DropOwnLinkInput, DropOwnLinkResult, LiveTool, ThreadView, BoardErrorItem, BoardSnapshot, QuotaWindow, ProviderQuota, QuotaSnapshot, ProviderAuth, AccountEmails, AuthSnapshot, AccountBackend, AccountLogoutInput, AccountLogoutResult, PermissionMode, LocalFileOpener, Settings, DispatchProviderPreferences, DispatchPreferences, DispatchProfileSnapshotShape, DispatchProfileSnapshot, SetDispatchPreferenceInput, DispatchInput, ADOPT_THREAD_MESSAGE_MAX_CHARS, AdoptThreadInput, AdoptThreadResult, AdoptSessionInput, FollowUpInput, SteerThreadInput, SteerThreadResult, DismissFailedFollowUpInput, DismissFailedFollowUpResult, UnqueueFollowUpInput, UnqueueFollowUpResult, DeliverQueuedNowInput, DeliverQueuedNowResult, CompactThreadInput, SetThreadSnoozeInput, SetThreadPinnedInput, SetThreadRecurringPromptInput, SetOwnThreadRecurringPromptInput, SetOwnThreadRecurringPromptResult, GetOwnThreadRecurringPromptInput, OwnThreadRecurringPromptResult, SetOwnThreadTimerInput, CancelOwnThreadTimerInput, ListOwnThreadTimersInput, OwnThreadTimersResult, ThreadActivityItem, ListOwnThreadActivityInput, OwnThreadActivityResult, SetOwnThreadTimerResult, CancelOwnThreadTimerResult, SetOwnThreadStopHookInput, SetOwnThreadHeartbeatInput, ThreadPluginReloadResult, RenameThreadInput, AiRenameThreadInput, AiRenameThreadResult, SetOwnThreadTitleInput, SetOwnThreadTitleResult, SetThreadPermissionInput, SetThreadPermissionResult, ThreadProfileOptionsInput, ThreadProfileOptionsResult, ThreadSkillSource, ThreadSkill, ThreadSkillsInput, ThreadSkillsResult, SetThreadProfileInput, SetThreadProfileResult, UpgradeThreadModelInput, UpgradeThreadModelResult, DISPATCH_TASK_BANNER, DISPATCH_TASK_BANNER_MARKER, HUMAN_GAP_FLOOR_MS, GithubWakeItem, GithubWakeSteer, WAKE_SCOPE, WAKE_REF, WAKE_SINGLE, WAKE_MULTI_HEAD, PR_WATCH_FINISHED, PR_WATCH_CI_PASSED, PR_WATCH_CI_GATED, PR_WATCH_STATE, PR_WATCH_CI_FAILED, GithubStatus, GithubRefCard, GithubRefPreviewInput, GithubRefPreviewResult, GithubItem, GithubListInput, GithubListResult, GithubBatchInput, GithubBatchResult, BoardMeta, ServerEvent, TranscriptEdit, TranscriptTodo, TranscriptToolCall, TranscriptPart, TranscriptMessage, TranscriptPageCursor, EditedFile, TranscriptPage, TranscriptEarlierInput, SocketTranscriptSlug, SocketFilePath, SocketTranscriptClientMsg, SocketFileClientMsg, SocketClientMsg, ProjectCard, ProjectRailCounts, PROJECT_ICON_MAX_BASE64_CHARS, DirectoryPickResult, ThreadLocation, FRIZZ_ROUTE_PREFIX, DEFAULT_PORT;
 var init_src = __esm({
   "packages/shared/src/index.ts"() {
     "use strict";
@@ -13560,7 +13538,6 @@ var init_src = __esm({
     init_code_fences();
     init_delta();
     init_drainable_worker();
-    init_frizz_md();
     init_interactions();
     init_receipt_bus();
     init_relay_protocol();
@@ -13662,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"
@@ -14859,6 +14836,19 @@ var init_src = __esm({
       // ambiguous, and only the operator decides to risk a second copy.
       supersedes: external_exports.string().min(1).max(200).optional()
     });
+    SteerThreadInput = external_exports.object({
+      from: ThreadSlug,
+      to: ThreadSlug,
+      message: external_exports.string().min(1).max(1e5)
+    }).strict();
+    SteerThreadResult = external_exports.object({
+      slug: ThreadSlug,
+      title: external_exports.string(),
+      // What the target was doing when the message arrived: `running` ⇒ it reads it at its next tool
+      // boundary; `resting` ⇒ the message started its next turn; `reopened` ⇒ it was marked done and this
+      // message put it back on the board.
+      delivery: external_exports.enum(["running", "resting", "reopened"])
+    }).strict();
     DismissFailedFollowUpInput = external_exports.object({
       slug: ThreadSlug,
       deliveryId: external_exports.string().min(1).max(200)
@@ -21199,11 +21189,13 @@ function readRegistry(home = homedir9()) {
   try {
     const parsed = JSON.parse(raw);
     if (parsed?.version !== 1 || !Array.isArray(parsed.projects)) return { ...EMPTY, projects: [] };
+    const forgotten = Array.isArray(parsed.forgotten) ? parsed.forgotten.filter((id) => typeof id === "string") : [];
     return {
       version: 1,
       projects: parsed.projects.filter(
         (p) => p && typeof p.id === "string" && typeof p.path === "string" && typeof p.slug === "string"
-      )
+      ),
+      ...forgotten.length > 0 ? { forgotten } : {}
     };
   } catch {
     return { ...EMPTY, projects: [] };
@@ -21267,7 +21259,12 @@ 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);
+    if (registry.forgotten.length === 0) delete registry.forgotten;
+  }
   const at = (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
   const byId = registry.projects.find((p) => p.id === input.id);
   if (byId) {
@@ -25461,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";
@@ -25600,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 };
 }
@@ -25643,13 +25642,19 @@ function cleanupSandbox(home) {
 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 refused = isHomeDirectory(candidate, home) ? "home" : isWorldWritable(candidate) ? "world-writable" : void 0;
-  if ((known || hasProjectMarker(candidate)) && !refused)
-    return { kind: "open", workspace: resolveWorkspace(cwd, home, env) };
-  const host = mostRecentProject(home, env);
-  const reason = refused ?? "unadopted";
-  if (!host) return { kind: "empty", directory: candidate, reason };
-  return reason === "unadopted" ? { kind: "offer", workspace: host, directory: candidate } : { kind: "grid", workspace: host };
+  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)) {
@@ -26006,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";
@@ -26251,7 +26256,7 @@ var Supervisor = class {
   watchSubscribe;
   reexec;
   supervisorLock;
-  statusPublisherToken = randomUUID5();
+  statusPublisherToken = randomUUID6();
   processGeneration = currentProcessGeneration();
   ownerToken;
   launchTarget;
@@ -27207,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,
@@ -27363,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 {
@@ -27464,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 });
@@ -27490,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";
@@ -27535,7 +27540,7 @@ function wrapLease(lease) {
     token: lease.token,
     pid: lease.pid,
     processStart: lease.processStart,
-    publisherToken: randomUUID7()
+    publisherToken: randomUUID8()
   };
 }
 function acquireStableServerOwner(roots) {
@@ -27666,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
@@ -27720,10 +27726,6 @@ var workspace = (() => {
       return workspaceFromLaunchTarget(pinned);
     }
     const intent = resolveLaunchIntent();
-    if (intent.kind === "empty")
-      throw new Error(
-        intent.reason === "home" ? "frizz cannot open your home directory as a project, and there is no other project to show yet. cd into a repository and run frizz there." : intent.reason === "world-writable" ? `A folder every account can write to cannot be a project: ${intent.directory}. Run frizz in a folder only you can write to.` : `${intent.directory} is not a Frizz project yet, and there is no other project to show. Run frizz inside a repository, or add this one from the projects page once a board is open.`
-      );
     launchIntent = intent;
     return intent.workspace;
   } catch (error) {
@@ -27869,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);
@@ -27880,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.9",
+  "version": "0.13.11",
   "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.18",
+    "version": "0.15.22",
     "protocol": 1,
     "dataEpoch": 1
   }