@bivy/bivy 0.20.0 → 0.20.1-staging.10

package/dist/remote/tailnet.js

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 Petter André Sjulstad
+//
+// The other machines on your tailnet that run Bivy, so a machine reached over
+// Tailscale can offer the rest. Tailscale lists the peers; each is asked for
+// Bivy's hello at its tailnet address, which only answers where `bivy
+// tailscale` is on.
+import { execFile } from "node:child_process";
+/** Peers from `tailscale status --json`, without the machine itself. */
+export function parseTailnetPeers(text) {
+    let status;
+    try {
+        status = JSON.parse(text);
+    }
+    catch {
+        return [];
+    }
+    return Object.values(status?.Peer ?? {})
+        .map((p) => ({ dnsName: String(p.DNSName ?? "").replace(/\.$/, ""), hostName: String(p.HostName ?? ""), online: p.Online === true, os: p.OS }))
+        .filter((p) => p.dnsName.endsWith(".ts.net"));
+}
+function tailscaleStatus() {
+    return new Promise((resolve) => {
+        execFile("tailscale", ["status", "--json"], { timeout: 3000, maxBuffer: 4 * 1024 * 1024 }, (error, stdout) => resolve(error ? "" : stdout));
+    });
+}
+async function hello(peer, fetchImpl) {
+    try {
+        const res = await fetchImpl(`https://${peer.dnsName}/api/direct/hello`, { signal: AbortSignal.timeout(2500) });
+        const body = await res.json();
+        if (!res.ok || body?.bivy !== true)
+            return null;
+        return { name: typeof body.name === "string" && body.name ? body.name : peer.hostName, url: `https://${peer.dnsName}`, nodeId: typeof body.nodeId === "string" ? body.nodeId : undefined, os: peer.os, online: true, self: false };
+    }
+    catch {
+        return null;
+    }
+}
+/** Online tailnet peers running Bivy over Tailscale. Offline peers aren't asked. */
+export async function discoverTailnetMachines(deps = {}) {
+    const peers = parseTailnetPeers(await (deps.status ?? tailscaleStatus)()).filter((p) => p.online);
+    const found = await Promise.all(peers.map((p) => hello(p, deps.fetchImpl ?? fetch)));
+    return found.filter((m) => m !== null).sort((a, b) => a.name.localeCompare(b.name));
+}

package/dist/server.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (c) 2026 Petter André Sjulstad
 import fs from "node:fs";
-import { createNodeUpdateChecker, updateRegistryUrl } from "./node-update.js";
+import { createNodeUpdateChecker, managedInstall, updateRegistryUrl } from "./node-update.js";
 import { createRemoteSessionAdmission, RemoteSessionAdmissionError } from "./session/remote-session-admission.js";
 import { requiresExistingSession, resolveTargetSession } from "./session/target-session.js";
 import path from "node:path";
@@ -74,7 +74,7 @@ import { exportProviderAuth, exportAccountApiKeys, exportAccountOAuthCredentials
 import { listProviders } from "./runtime/provider-catalog.js";
 import { exportLocalModels, importLocalModels } from "./runtime/local-model-store.js";
 import { sessionLikeFields } from "./session/start-like.js";
-import { MAX_SUGGESTION_TEXT, MAX_SUGGESTION_TITLE, isTaskSuggestion } from "./session/suggestions.js";
+import { MAX_SUGGESTION_TEXT, MAX_SUGGESTION_TITLE, SUGGESTION_RUNS, isTaskSuggestion } from "./session/suggestions.js";
 import { BIVY_AGENT_NOTE, mergeSyncedAgentInstructions, readAgentInstructions, sessionInstructions, writeAgentInstructions, MAX_AGENT_INSTRUCTIONS_BYTES } from "./agent-instructions.js";
 import { execEphemeralRequest } from "./ephemeral-exec.js";
 import { ApprovalManager } from "./approval.js";
@@ -84,8 +84,14 @@ import { canOpenBrowser, openBrowser } from "./browser-open.js";
 import { openOAuthLoginOnNode } from "./runtime/oauth/oauth-node-open.js";
 import { collectNodeStats } from "./node-stats.js";
 import { SessionEventCoalescer } from "./session-event-coalescer.js";
-import { authMiddleware, resolveAuth, isAuthorized, requestOriginAllowed } from "./auth.js";
-import { RelayConnector, loadRelayConfig, soloCredentials } from "./remote/index.js";
+import { readMachineTheme, watchMachineTheme } from "./machine-theme.js";
+import { authMiddleware, resolveAuth, isAuthorized, requestOriginAllowed, markRemoteListener } from "./auth.js";
+import { PairCodes } from "./pair-codes.js";
+import { accessReport } from "./access.js";
+import { hostedEndpoints } from "./hosted-endpoints.mjs";
+import http from "node:http";
+import { webAppDirs, webAppRouter } from "./web-app.js";
+import { RelayConnector, loadRelayConfig, loadDirectListenerConfig, discoverTailnetMachines, soloCredentials } from "./remote/index.js";
 import { readEphemeralTeardownConfig, shouldSelfTeardown, snapshotsDurableForTeardown, performSelfTeardown } from "./ephemeral-teardown.js";
 import { buildSessionSnapshot, applySessionSnapshot } from "./session/snapshot.js";
 import { clearTurnActivity } from "./session/turn-activity.js";
@@ -919,6 +925,10 @@ async function maybeNotifyBivyUpdate() {
 // in both. Returns a friendly error instead of throwing when it can't be found
 // (e.g. an unusual layout), so the banner can fall back to the manual command.
 function runBivyUpdate() {
+    // A system package (the AUR's `bivy`) owns this install; its manager updates it.
+    const managed = managedInstall(repoRoot);
+    if (managed)
+        return { ok: false, error: `Bivy is installed by ${managed.manager} on this machine. Update it there${managed.update ? `: ${managed.update}` : ""}, then restart Bivy.` };
     const script = path.join(repoRoot, "bin", "bivy.mjs");
     if (!fs.existsSync(script)) {
         return { ok: false, error: "Could not locate the bivy CLI on this node — run `bivy update` in a terminal." };
@@ -1070,9 +1080,16 @@ const accessDevices = createAccessDeviceController({
     create: (name) => identity.createDevice(name),
     revoke: (id) => identity.revokeDevice(id),
     onCreated: (device) => broadcast({ type: "device.created", device }),
-    onRevoked: (id) => broadcast({ type: "device.revoked", id }),
+    onRevoked: (id) => {
+        broadcast({ type: "device.revoked", id });
+        // A revoked token loses its open sockets now, not at its next reconnect.
+        for (const socket of clients)
+            if (socketDeviceIds.get(socket) === id)
+                socket.close(1008, "Unauthorized");
+    },
 });
 const clients = new Set();
+const socketDeviceIds = new WeakMap();
 const commandProcesses = new Map();
 const oauthLogins = new Map();
 // A browser-initiated subscription login parks the node on `manualCodePromise`
@@ -1712,6 +1729,9 @@ const commands = [
 // network, background tab); used by both broadcast paths below.
 const CLIENT_BACKPRESSURE_BYTES = 8 * 1024 * 1024;
 let projectClientMessage;
+// The machine's desktop theme (Omarchy), so every connected app can match it.
+let machineTheme = readMachineTheme();
+const machineThemeEvent = () => ({ type: "node.theme", theme: machineTheme });
 function broadcast(payload) {
     const p = payload;
     if (p?.type === "session.event" && p.sessionId && projectClientMessage)
@@ -2279,6 +2299,25 @@ appRegistry.on("notes", (viewId) => {
         });
     }, NOTES_NOTIFY_MS).unref?.();
 });
+// Asking every peer takes a moment; a short cache keeps switcher opens instant.
+let tailnetCache = null;
+async function tailnetMachines() {
+    const direct = loadDirectListenerConfig(appDir);
+    if (!direct?.hostname)
+        return [];
+    if (!tailnetCache || Date.now() - tailnetCache.at > 15_000)
+        tailnetCache = { at: Date.now(), machines: discoverTailnetMachines() };
+    const self = { name: identity.name, url: `https://${direct.hostname}`, nodeId: identity.nodeId, os: process.platform, online: true, self: true };
+    return [self, ...(await tailnetCache.machines).filter((m) => m.url !== self.url)];
+}
+function currentAccess() {
+    const relay = loadRelayConfig(appDir);
+    return accessReport({
+        tailscaleHostname: loadDirectListenerConfig(appDir)?.hostname,
+        relay: relay ? { controlPlaneUrl: relay.controlPlaneUrl, room: relay.room, roomToken: relay.roomToken } : null,
+        hostedControlPlane: hostedEndpoints(process.env).controlPlane,
+    });
+}
 const RELAY_COMMANDS = {
     ...createAppCommands(appService, (id) => { const record = resolveSession(id); return record ? harnessDirFor(record) : undefined; }, (app) => {
         const record = resolveSession(app.sessionId);
@@ -2296,6 +2335,14 @@ const RELAY_COMMANDS = {
     // (see runBivyUpdate). The node restarts itself when the update lands, so the
     // client just sees the socket reconnect on the new build; a failure to even
     // start reports back so the banner can show the manual command.
+    // The machines on this machine's tailnet that run Bivy, this one first.
+    async "tailnet.machines"(msg, ctx) {
+        ctx.reply({ type: "tailnet.machines.ok", requestId: msg.requestId, machines: await tailnetMachines() });
+    },
+    // How this machine can be reached and what the next setup would add (src/access.ts).
+    "access.get"(msg, ctx) {
+        ctx.reply({ type: "access.get.ok", requestId: msg.requestId, ...currentAccess() });
+    },
     "node.update"(_msg, ctx) {
         const result = runBivyUpdate();
         ctx.reply({ type: "node.update.result", ok: result.ok, error: result.error });
@@ -2518,10 +2565,7 @@ const RELAY_COMMANDS = {
         const rec = resolveSession(sid);
         if (!rec)
             return;
-        rec.session.setName(newName);
-        persistSessionMetadata(rec);
-        ctx.broadcast({ type: "session.renamed", sessionId: rec.id, sessionFile: rec.sessionFile, name: newName });
-        scheduleAdvertise();
+        sessionNamer.setSessionName(rec, newName);
     },
     abort(msg, ctx) {
         const sessionId = String(msg.sessionId ?? "");
@@ -2661,6 +2705,7 @@ const RELAY_COMMANDS = {
         // Relay clients request the list on every connect/reconnect. Replay even an
         // empty update state so a banner from the previous daemon is cleared.
         relay?.sendEvent(nodeUpdates.snapshot());
+        relay?.sendEvent(machineThemeEvent());
         void checkBivyUpdate();
         relay?.sendEvent({ type: "sessions.list", sessions: await sessionListRows() });
     },
@@ -9337,7 +9382,8 @@ app.use((_req, res, next) => {
 // (OAuth callback, GitHub App manifest). It does NOT host the web UI — the
 // React/Vite PWA (@bivy/web) is served exclusively by the hosted or self-hosted
 // control plane. `/` returns a small informational stub for anyone who points a
-// browser straight at the node.
+// browser straight at the node. The one exception is the direct listener for
+// `bivy tailscale` (below), which has no control plane and serves the app itself.
 app.get("/", (_req, res) => {
     res.setHeader("Cache-Control", "no-store, max-age=0");
     res
@@ -9447,6 +9493,26 @@ app.post("/api/auth/bootstrap", sensitiveRateLimiter, (req, res) => {
     const { device, token } = accessDevices.create(name);
     res.json({ ok: true, device, token });
 });
+// Pairing a device that reaches the node directly (Tailscale): trade a one-time
+// code minted on this machine for a device token. Registered before the auth
+// middleware because the caller has no token yet; the code is the credential.
+const pairCodes = new PairCodes();
+app.post("/api/auth/pair", sensitiveRateLimiter, (req, res) => {
+    if (!requestOriginAllowed(req))
+        return res.status(403).json({ error: "Forbidden origin" });
+    if (!pairCodes.redeem(String(req.body?.code ?? ""))) {
+        return res.status(401).json({ error: "This pairing link is used or expired. Run 'bivy tailscale pair' on your machine for a new one." });
+    }
+    const name = String(req.body?.name ?? "").trim().slice(0, 80) || "Paired device";
+    const { device, token } = accessDevices.create(name);
+    res.json({ ok: true, device, token });
+});
+// Identifies a Bivy node to the other machines on its tailnet, so each can list
+// the rest (tailnet.machines). Public, like /healthz: it says only that Bivy
+// runs here and under which name; the direct listener is tailnet-only.
+app.get("/api/direct/hello", (_req, res) => {
+    res.json({ bivy: true, name: identity.name, nodeId: identity.nodeId });
+});
 // All other /api routes require auth (loopback may bypass, per config and host
 // — see loopbackAllowed()/isMultiUserHost() in src/auth.ts).
 app.use("/api", authMiddleware(identity, {
@@ -9457,6 +9523,23 @@ app.use("/api", authMiddleware(identity, {
     used: (sessionId, call) => { if (call.method !== "GET")
         auditLog.record({ kind: "agent.call", session: sessionId, tool: `${call.method} ${call.path}` }); },
 }));
+// Mint a pairing code for a direct (Tailscale) device. Only callers already
+// trusted by this node get one: the owner's CLI, or an already-paired device.
+app.post("/api/auth/pair-codes", (_req, res) => {
+    const direct = loadDirectListenerConfig(appDir);
+    const { code, expiresAt } = pairCodes.issue();
+    const url = direct?.hostname ? `https://${direct.hostname}/#pair=${code}` : undefined;
+    res.json({ ok: true, code, expiresAt, url });
+});
+// Start, move or stop the direct listener after `bivy tailscale` changes it.
+app.post("/api/direct/reload", async (_req, res, next) => {
+    try {
+        res.json({ ok: true, ...(await reloadDirectListener()) });
+    }
+    catch (error) {
+        next(error);
+    }
+});
 // Reload relay.json without forcing the user to restart the whole node. This is
 // used by `bivy relay:setup` after it enrolls the node.
 app.post("/api/relay/reload", (_req, res) => {
@@ -9823,10 +9906,7 @@ app.post("/api/sessions/rename", (req, res, next) => {
         const rec = resolveSession(sid);
         if (!rec)
             return res.status(404).json({ error: "Session not found" });
-        rec.session.setName(newName);
-        persistSessionMetadata(rec);
-        broadcast({ type: "session.renamed", sessionId: rec.id, sessionFile: rec.sessionFile, name: newName });
-        scheduleAdvertise();
+        sessionNamer.setSessionName(rec, newName);
         res.json({ ok: true, name: newName });
     }
     catch (error) {
@@ -11665,17 +11745,32 @@ app.get("/api/session/:id/automations/apply/:proposalId", (req, res) => {
         return res.status(404).json({ error: "Proposal not found" });
     res.json(proposal);
 });
+// `bivy title "<title>"`: the agent names its own session, e.g. when the first
+// message made a poor title or the work changed direction.
+const MAX_SESSION_TITLE = 100;
+app.post("/api/session/:id/title", (req, res) => {
+    const record = openSessions.get(String(req.params.id));
+    if (!record)
+        return res.status(404).json({ error: "Session not found" });
+    const title = typeof req.body?.title === "string" ? req.body.title.replace(/\s+/g, " ").trim() : "";
+    if (!title || title.length > MAX_SESSION_TITLE)
+        return res.status(400).json({ error: `A title needs 1 to ${MAX_SESSION_TITLE} characters.` });
+    sessionNamer.setSessionName(record, title);
+    res.json({ ok: true, title });
+});
 // `bivy suggest "<task>"`: the agent proposes a task the user can start in one
-// tap, here or in a parallel session (see packages/web SuggestionCard).
+// tap, here, through this agent's sub-agents, or in a parallel session; `run`
+// is the one the agent recommends (see packages/web SuggestionCard).
 app.post("/api/session/:id/suggest", (req, res) => {
     const record = openSessions.get(String(req.params.id));
     if (!record)
         return res.status(404).json({ error: "Session not found" });
     const text = typeof req.body?.text === "string" ? req.body.text.trim() : "";
     const title = typeof req.body?.title === "string" && req.body.title.trim() ? req.body.title.trim() : undefined;
-    const suggestion = { id: `suggestion-${randomBytes(8).toString("hex")}`, text, ...(title ? { title } : {}) };
+    const run = req.body?.run || undefined;
+    const suggestion = { id: `suggestion-${randomBytes(8).toString("hex")}`, text, ...(title ? { title } : {}), ...(run ? { run } : {}) };
     if (!isTaskSuggestion(suggestion))
-        return res.status(400).json({ error: `A suggestion needs text (up to ${MAX_SUGGESTION_TEXT} characters) and an optional title (up to ${MAX_SUGGESTION_TITLE}).` });
+        return res.status(400).json({ error: `A suggestion needs text (up to ${MAX_SUGGESTION_TEXT} characters), an optional title (up to ${MAX_SUGGESTION_TITLE}) and an optional run (${SUGGESTION_RUNS.join(", ")}).` });
     eventLog.appendSuggestion(record.id, { afterMessageCount: record.session.getMessages().length, suggestion });
     broadcast(stampSessionEvent({ type: "session.event", sessionId: record.id, event: { type: "suggestion", id: suggestion.id, suggestion } }));
     res.json({ ok: true, id: suggestion.id });
@@ -12005,6 +12100,11 @@ const server = app.listen(port, host, async () => {
     console.log(`Agent data dir: ${piDir}`);
     console.log(`Workspace: ${defaultWorkspace}`);
     startRelayIfConfigured();
+    watchMachineTheme((theme) => {
+        machineTheme = theme;
+        broadcast(machineThemeEvent());
+    });
+    void reloadDirectListener().catch((error) => console.error("[direct] Could not start the direct listener:", error instanceof Error ? error.message : error));
     void syncAgentBridges().catch((error) => console.warn("[bridges] Could not install agent bridges; they will install on first use:", error instanceof Error ? error.message : error));
     if (appGateway) {
         appGateway.server.on("error", (error) => { console.error("[apps] Preview gateway could not start:", error); shutdown("preview gateway failure"); });
@@ -12071,6 +12171,49 @@ server.on("error", (error) => {
     process.exit(1);
 });
 const wss = new WebSocketServer({ server, path: "/ws" });
+// Direct listener (`bivy tailscale`): the same API and WebSocket, plus the web
+// app, on a loopback port `tailscale serve` exposes to the tailnet over HTTPS.
+// markRemoteListener keeps its proxied, loopback-looking connections from ever
+// getting loopback trust; every caller needs a device token.
+const directWebApp = webAppRouter(webAppDirs(repoRoot));
+let directListener = null;
+let directOwner;
+async function reloadDirectListener() {
+    const config = loadDirectListenerConfig(appDir);
+    directOwner = config?.owner;
+    if (directListener && directListener.port !== config?.port) {
+        const previous = directListener;
+        directListener = null;
+        for (const client of previous.wss.clients)
+            client.terminate();
+        previous.wss.close();
+        previous.server.closeAllConnections();
+        await new Promise((resolve) => previous.server.close(() => resolve()));
+    }
+    if (config && !directListener) {
+        const directApp = express();
+        directApp.disable("x-powered-by");
+        if (directWebApp)
+            directApp.use(directWebApp);
+        directApp.use(app);
+        const listener = http.createServer(directApp);
+        // The owner's own tailnet devices come in on their Tailscale identity.
+        markRemoteListener(listener, { trustedLogin: () => directOwner });
+        const directWss = new WebSocketServer({ server: listener, path: "/ws" });
+        directWss.on("connection", (socket, req) => wss.emit("connection", socket, req));
+        await new Promise((resolve, reject) => {
+            listener.once("error", reject);
+            listener.listen(config.port, "127.0.0.1", () => {
+                listener.off("error", reject);
+                resolve();
+            });
+        });
+        listener.on("error", (error) => console.error("[direct] Listener error:", error));
+        directListener = { port: config.port, server: listener, wss: directWss };
+        console.log(`[direct] Listening on 127.0.0.1:${config.port}${config.hostname ? ` for https://${config.hostname}` : ""}${directWebApp ? "" : " (web app not built; API only)"}`);
+    }
+    return { enabled: Boolean(directListener), port: directListener?.port, webApp: Boolean(directWebApp) };
+}
 wss.on("connection", (socket, req) => {
     // Reject cross-origin / DNS-rebinding upgrades before auth: loopback bypasses
     // auth by default, so a page the user merely visited could otherwise open a
@@ -12079,11 +12222,14 @@ wss.on("connection", (socket, req) => {
         socket.close(1008, "Forbidden origin");
         return;
     }
-    if (!isAuthorized(resolveAuth(identity, req))) {
+    const socketAuth = resolveAuth(identity, req);
+    if (!isAuthorized(socketAuth)) {
         socket.close(1008, "Unauthorized");
         return;
     }
     clients.add(socket);
+    if (socketAuth.deviceId)
+        socketDeviceIds.set(socket, socketAuth.deviceId);
     // Terminals opened on this socket; closed when the socket disconnects so a
     // dropped browser tab doesn't leak shells. Output is unicast to this socket.
     const ownedTerminals = new Set();
@@ -12099,6 +12245,7 @@ wss.on("connection", (socket, req) => {
     // a freshly-opened app surfaces a newly-available update without waiting for a
     // session turn.
     socket.send(JSON.stringify(nodeUpdates.snapshot()));
+    socket.send(JSON.stringify(machineThemeEvent()));
     void checkBivyUpdate();
     socket.on("message", (raw) => {
         let msg;

package/dist/session/run-terminal.js

@@ -180,7 +180,7 @@ export function createRunTerminals(deps) {
             deps.broadcast({ type: "terminal.idle", termId: id, at: Date.now() });
             broadcastRunTerminalList();
             const who = displayName || "An agent";
-            deps.sendNotificationHint({ kind: "agent_waiting", title: `${who} is waiting`, body: `${who} has been quiet for a bit — it may be waiting for your input.` });
+            deps.sendNotificationHint({ kind: "agent_waiting", title: `${who} is waiting`, body: `${who} has been quiet for a bit — it may be waiting for your input.`, ...runTarget(id) });
         }, IDLE_NOTIFY_INTERVAL));
     }
     function clearRunIdleNotify(id) {
@@ -201,7 +201,11 @@ export function createRunTerminals(deps) {
         lastBellNotify.set(id, now);
         const meta = terminals.meta(id);
         const who = meta?.name?.trim() || meta?.label?.trim() || "A terminal";
-        deps.sendNotificationHint({ kind: "terminal_bell", title: "Terminal bell", body: `${who} rang the terminal bell — it may be waiting for you.` });
+        deps.sendNotificationHint({ kind: "terminal_bell", title: "Terminal bell", body: `${who} rang the terminal bell — it may be waiting for you.`, ...runTarget(id) });
+    }
+    function runTarget(id) {
+        const sessionId = terminals.meta(id)?.sessionId;
+        return sessionId ? { sessionId, targetSessionId: sessionId } : {};
     }
     function clearBellNotify(id) {
         lastBellNotify.delete(id);

package/dist/session/session-namer.js

@@ -180,6 +180,12 @@ export function createSessionNamer(deps) {
                 catch (error) {
                     console.warn("Session naming suggestion failed", error);
                 }
+                // A title set while the model was thinking (the user, or the agent with
+                // `bivy title`) wins over the refinement.
+                if (record.session.getName() !== fallback) {
+                    record.namedFromFirstPrompt = true;
+                    return;
+                }
                 if (finalName !== fallback) {
                     record.session.setName(finalName);
                     deps.persistSessionMetadata(record);
@@ -211,8 +217,8 @@ export function createSessionNamer(deps) {
             record.naming = false;
         }
     }
-    /** Manually set a session's title (e.g. GitHub-issue pickup) and lock it so the
-     *  first-prompt namer won't overwrite it. */
+    /** Manually set a session's title (a rename in the app, `bivy title`, a
+     *  GitHub-issue pickup) and lock it so the first-prompt namer won't overwrite it. */
     function setSessionName(record, name) {
         const clean = name.trim();
         if (!clean)

package/dist/session/session-tokens.js

@@ -44,7 +44,7 @@ export function createSessionTokenCodec(key = randomBytes(32)) {
  */
 export const SESSION_TOKEN_ROUTES = [
     { method: "GET", path: /^\/api\/session\/([^/]+)\/context$/, session: "path" },
-    { method: "POST", path: /^\/api\/session\/([^/]+)\/(attach|suggest|notify)$/, session: "path" },
+    { method: "POST", path: /^\/api\/session\/([^/]+)\/(attach|suggest|notify|title)$/, session: "path" },
     { method: "POST", path: /^\/api\/session\/([^/]+)\/ask$/, session: "path" },
     { method: "GET", path: /^\/api\/session\/([^/]+)\/ask\/[^/]+$/, session: "path" },
     { method: "POST", path: /^\/api\/session\/([^/]+)\/ask\/[^/]+\/wait$/, session: "path" },

package/dist/session/suggestions.js

@@ -1,5 +1,8 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (c) 2026 Petter André Sjulstad
+/** here: this session's agent. subagents: this agent, through its own sub-agents. new: a session per task. */
+export const SUGGESTION_RUNS = ["here", "subagents", "new"];
+const isRun = (value) => value === undefined || SUGGESTION_RUNS.includes(value);
 export const SUGGESTION_BLOCK = "bivy_suggestion";
 export const MAX_SUGGESTION_TEXT = 4000;
 export const MAX_SUGGESTION_TITLE = 120;
@@ -9,5 +12,6 @@ export function isTaskSuggestion(value) {
     const s = value;
     return typeof s.id === "string" && s.id.length > 0
         && typeof s.text === "string" && s.text.length > 0 && s.text.length <= MAX_SUGGESTION_TEXT
-        && (s.title === undefined || (typeof s.title === "string" && s.title.length <= MAX_SUGGESTION_TITLE));
+        && (s.title === undefined || (typeof s.title === "string" && s.title.length <= MAX_SUGGESTION_TITLE))
+        && isRun(s.run);
 }

package/dist/web-app.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 Petter André Sjulstad
+//
+// The web app, served by the node itself on its direct listener (Tailscale).
+// Elsewhere the control plane serves it and the node stays a pure data plane;
+// here there is no control plane, so the node hands out the same build and
+// tells it, through /runtime-config.js, to talk to this node directly.
+import fs from "node:fs";
+import path from "node:path";
+import express from "express";
+/** Where a packaged install and a source checkout keep the built app and its icons. */
+export function webAppDirs(packageRoot) {
+    return [
+        path.join(packageRoot, "web"),
+        path.join(packageRoot, "packages", "web", "dist"),
+        path.join(packageRoot, "services", "control-plane", "public"),
+    ].filter((dir) => fs.existsSync(dir));
+}
+/** Paths the node itself answers, never the app shell. */
+const NODE_ROUTES = ["/api", "/ws", "/healthz", "/github"];
+function noStore(res) {
+    res.setHeader("Cache-Control", "no-store, max-age=0");
+}
+/** Serves the app shell, assets and a direct-mode runtime config; passes on anything else. */
+export function webAppRouter(dirs) {
+    const indexDir = dirs.find((dir) => fs.existsSync(path.join(dir, "index.html")));
+    if (!indexDir)
+        return null;
+    // Read once: the shell is served from memory, with no file access per request.
+    const indexHtml = fs.readFileSync(path.join(indexDir, "index.html"));
+    const router = express.Router();
+    router.get("/runtime-config.js", (_req, res) => {
+        noStore(res);
+        res.type("application/javascript").send(`globalThis.__BIVY_RUNTIME_CONFIG__ = ${JSON.stringify({ directNode: true })};\n`);
+    });
+    for (const dir of dirs) {
+        router.use(express.static(dir, {
+            index: false,
+            setHeaders(res, filePath) {
+                const name = path.basename(filePath);
+                if (name === "index.html" || name === "sw.js" || name.startsWith("workbox-"))
+                    noStore(res);
+            },
+        }));
+    }
+    // Client-side routes (`/sessions/…`, `/settings`, `/share`, …) load the shell;
+    // the node's own routes pass through.
+    router.get(/.*/, (req, res, next) => {
+        if (NODE_ROUTES.some((prefix) => req.path === prefix || req.path.startsWith(`${prefix}/`)) || !req.accepts("html"))
+            return next();
+        noStore(res);
+        res.type("html").send(indexHtml);
+    });
+    return router;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivy/bivy",
-  "version": "0.20.0",
+  "version": "0.20.1-staging.10",
   "type": "module",
   "license": "AGPL-3.0-only",
   "description": "Run coding agents on machines you own. Open-source, self-hostable agent workspace.",
@@ -65,7 +65,7 @@
     "lodash-es": "4.18.1",
     "undici": "8.11.2"
   },
-  "readme": "# Bivy\n\n[![npm](https://img.shields.io/npm/v/@bivy/bivy?color=2b6cb0&label=%40bivy%2Fbivy)](https://www.npmjs.com/package/@bivy/bivy)\n[![license: AGPL-3.0-only](https://img.shields.io/badge/license-AGPL--3.0--only-2b6cb0)](LICENSE)\n[![node](https://img.shields.io/badge/node-%E2%89%A520-2b6cb0)](https://nodejs.org)\n\n**Local coding agents that show their work. Anywhere.**\n\nBivy is the open-source workspace for coding agents. It runs Claude Code, Codex,\nPi, OpenCode and other agents on your own machine. Reach them from a browser or\nyour phone, with the live session, its terminal, its approvals, and the app\nthey're building right in the chat. Try it, mark what's wrong, and send it back.\n\nBivy is not another coding agent and not a cloud development machine. The agent\nstays local and does the coding with your model provider. Your repos, tools,\ndatabases, and services stay where they are. Bivy gives you remote access to all\nof it, plus live previews, automations, and review.\n\n- **Live previews.** The running app beside the chat. Mark it, send it back,\n  share it with someone who has no Bivy account.\n- **Automations.** GitHub issues, failed CI, Linear, Slack, schedules, and\n  webhooks start the work. It comes back as a preview link or a pull request.\n- **Any agent.** Hit a usage limit? Fork the session to another agent, or let\n  Bivy retry when the limit resets.\n- **Your machine, anywhere.** Start at your desk, pick the session up on your\n  phone. The machine dials out, so there are no ports to open, and session\n  traffic is end-to-end encrypted.\n\n**[Start free on Bivy Cloud](https://app.bivy.sh)** ·\n**[Quickstart](docs/quickstart.md)** ·\n**[Documentation](docs/README.md)** ·\n**[Self-host](docs/deploy-images.md)** ·\n**[Website](https://bivy.sh)**\n\n**Recommended:** sign in at [app.bivy.sh](https://app.bivy.sh), then copy your\npersonalized **Connect a Machine** command into a terminal on your Mac or Linux\ncomputer. It installs and enrolls the machine without another Bivy login. The\nbrowser connects automatically; choose a repository and send your first task\nright there.\n\nPrefer starting from the terminal?\n\n```bash\ncurl -fsSL https://bivy.sh/install.sh | bash  # install + guided setup\ncd your-repo\nbivy run claude                            # or codex, pi, opencode\nbivy open                                  # continue in the web app (needs remote setup)\n```\n\nBivy Cloud hosts the app, control plane, and relay—not the machines running your\nagents. Connect a Mac, Linux computer, or existing server and bring your own\nagent subscription, model API key, or local model. You can also self-host the\nentire remote-access stack.\n\n> **Bivy is 0.x software.** Claude Code, Codex, Pi, OpenCode, and Grok are the\n> release-tested paths. Credential sync, resume, handoffs, approvals, and\n> sandboxing depend on the runtime. See the\n> [runtime support matrix](docs/runtime-support-matrix.md).\n\n## Don't just read the diff. Try the app.\n\nBivy lets you **use what the agent built and show it what to fix**, without a\nseparate deployment step.\n\n1. **Ask for a change.** The agent works in your repo with your existing tools\n   and local services.\n2. **Try the app.** Bivy finds the dev server the agent starts and opens it\n   beside the chat: web apps, terminals, and desktop apps. Use the running app,\n   not a screenshot of what the agent says it finished.\n3. **Mark what needs work.** Press and hold anything in the preview to mark it,\n   or drag to circle it, then say what you want. **Mark another** keeps\n   separate notes separate. The marks go to the agent with the element and page\n   context. No screenshots to paste.\n4. **Follow each note.** Every mark stays in the chat as a pin that resolves\n   itself: **Changed** when a later run changes what you marked, **Element\n   gone** when it leaves the page, **Done** when you say so.\n5. **Review the next version.** A new version waits on the preview pill instead\n   of reloading under you. Take it when you're ready, compare before and after,\n   inspect the diff and checks, and decide when the work is done.\n6. **Get a second opinion.** Share a preview link for 1 hour, 1 day, or 7 days.\n   Teammates and clients try the running app and leave notes without a Bivy\n   account. Make it view-only, or **Stop sharing** to end every link at once.\n\nOn Bivy Cloud, preview delivery is built in: no per-app domains, certificates,\npublic ports, or tunnels to configure. Self-hosters configure preview delivery\nonce for their Bivy deployment, not for every app. The app still needs its normal\nbuild or dev-server setup, and **the machine serving it must stay awake and\nonline**. These are development previews, not production hosting.\n\n**Share deliberately:** anyone with a preview link can use that app, including\nits live backend, until the link expires or you stop sharing.\nReviewer notes aren't sent to the agent automatically; you send them or explicitly\nallow agent access. Preview traffic uses HTTPS through the preview relay, not\nsession end-to-end encryption; the relay operator can see it.\n\n[App previews, visual feedback, and sharing →](docs/apps.md)\n\n## One workflow, from trigger to review\n\n```text\nPrompt · GitHub issue · CI failure · Linear · Slack · Schedule · Webhook\n                                 │\n                                 ▼\n                   Choose machine + agent + model\n                     + supported credentials\n                                 │\n                                 ▼\n                         Live agent session\n                     Join · steer · approve · stop\n                                 │\n                                 ▼\n                  Try app · inspect changes · checks\n                                 │\n                                 ▼\n                  Mark up · send feedback · iterate\n                                 │\n                                 ▼\n                      Share preview · review PR\n```\n\nA **Machine** is a computer or server you connect. A **Session** is live agent\nwork on that machine. A **Run** is delegated background work that creates a\nsession and tracks its outcome. An **Automation** is a reusable definition that\ncreates runs when an event matches.\n\nManual and automated work use the same kind of live session. You can join a run\nwhen it needs help rather than wait for a black-box job to finish.\n\n### Let events start the work\n\nAutomations turn recurring or incoming work into sessions you can join,\nsupervise, and review. An agent picks the task up on your machine and posts\nback a preview link or a pull request, so you try the result where the task\nlives and reply in the same session. Choose the repository, machine, agent,\nmodel, approval mode, sandbox setting, and maximum attempts.\n\n| Trigger | Example workflow |\n|---|---|\n| **GitHub issues and mentions** | Label an issue `bivy` or `bivy/<machine>`, or mention your Bivy GitHub App, to work toward a pull request. |\n| **Failed CI** | Match a failed workflow, ask the agent to reproduce it, make a fix, and run the affected checks. |\n| **Linear** | Label an issue to start work without copying its description into an agent. |\n| **Slack** | Send a request from the conversation where the work came up. |\n| **Schedules** | Run a weekly dependency review, recurring maintenance, or a one-time task. |\n| **Signed webhooks** | Connect alerts, internal tools, or your own event sources. |\n\nConfigure automations in the app or version them with your repository in\n`.bivy/automations.yaml`:\n\n```bash\nbivy automation init\n# Edit the generated definition for your repository and workflow.\nbivy automation validate\nbivy automation test --event .bivy/events/failed-ci.yaml  # supply a local event fixture\nbivy automation apply\n```\n\nOr delegate a one-off job without creating an automation:\n\n```bash\nbivy runs start \"Review outdated dependencies and propose a small, tested update.\"\nbivy runs wait <id>\n```\n\nRuns keep routing and lifecycle evidence, check results, and output references\nin a reviewable Receipt. For unattended issue work, Bivy runs declared repository\nchecks after the agent's turn; failed required checks fail the run even if the\nagent reports success. A completed process alone is not proof that the task\nsucceeded.\n\n[Automation recipes →](docs/capability-recipes.md#let-events-start-runs) ·\n[Automations as code →](docs/automations-as-code.md) ·\n[Run outcomes and reliability limits →](docs/automation-runs.md)\n\n### Use every agent you pay for. Switch mid-task.\n\nRun Claude Code for one task, Codex for another, and Pi or OpenCode where they\nfit, side by side in one session list. Bivy supplies the shared session,\nremote-access, automation, and review surfaces; your chosen agent still does\nthe coding and uses your model provider.\n\n- **Hit a usage limit? Keep going.** When a turn fails on a limit, fork the\n  session, with its code and conversation, to another agent and model, or let\n  Bivy retry when the limit resets (the provider has to report a reset time).\n- **Get a second opinion.** `bivy delegate` hands a task to another agent, on\n  the same machine or a different one, and brings back its answer, branch, and\n  PR. `--to codex,claude@linux` sends one task to several agents to compare.\n- Choose an agent and, where supported, a model for each session or run.\n- Import existing Claude Code and Codex sessions.\n- Fork or move work to another agent or machine when a different setup fits\n  better. Continuation fidelity varies: some paths preserve native history,\n  while others replay portable turns or hand over a summary with the earlier\n  transcript as a local file.\n- Use agent-native logins, Bivy-managed credentials, or local inference.\n  Bivy's custom OpenAI-compatible endpoint registry currently feeds Pi;\n  other agents may need their own provider configuration.\n- Register your own ACP or headless process agent with `bivy agent add`.\n\nBivy does not replace your agent, provide model inference, or make every agent's\nfeatures identical. Consult the [support matrix](docs/runtime-support-matrix.md)\nand [handoff recipes](docs/capability-recipes.md#fork-or-move-a-session).\n\n### Less signing in. Less copying secrets.\n\nBivy syncs **Bivy-managed API keys and supported OAuth credentials** across\nenrolled machines for compatible runtimes. Connect supported credentials once\nand reuse them where you run work, rather than manually distributing keys to\neach machine.\n\nFor ordinary account sync, credentials are encrypted on the node before upload.\nThe control plane stores ciphertext and wrapped-key metadata; enrolled nodes\nshare access by wrapping the vault key to one another. Bivy Cloud does not\nreceive plaintext credentials through this sync path.\n\nYou can also keep credentials local, use labeled keys and project presets, or\nreference environment variables and 1Password instead of embedding secrets in\nconfiguration:\n\n```bash\nbivy provider login\nbivy credentials add anthropic work\nbivy secrets ref github.repo-token op://Bivy/GitHub/repo-token\n```\n\n**Not every CLI login syncs.** Native agent logins may still be per-machine;\nGitHub App private-key sync is separately opt-in. If you lose every node and\ndevice able to unwrap a vault, you must sign in to providers again. Explicit\nhosted-provisioning custody grants are separate from ordinary encrypted sync.\n\n[Credential sync and runtime coverage →](docs/credential-sync.md) ·\n[Credentials guide →](docs/credentials-guide.md) ·\n[Key storage →](docs/key-management.md)\n\n### Work in the environment you already have\n\nA clean cloud sandbox isn't always enough. Your agent may need the database\nrunning on localhost, an uncommitted change, an internal API behind your VPN,\nor a model running on your GPU. Bivy runs the agent where those things already\nexist, subject to that machine's permissions and the runtime's protection.\n\nConnect several machines to the same account: a laptop for interactive work,\na Linux server for background jobs, or a GPU box for local inference. Choose\nthe machine for each session or pin it in an automation. Repository runs can\nuse isolated Git worktrees without rebuilding the whole development environment.\n\n**The execution machine must stay awake and online.** To close your laptop and\nleave work running, run the agent on a different, always-on machine.\n\n[Environment and multi-machine recipes →](docs/capability-recipes.md)\n\n### Start at your desk. Continue anywhere.\n\nOpen the same session in the browser, phone PWA, or terminal. Watch work live,\nanswer questions, approve supported tool calls, or stop the agent.\n\n- Send screenshots, images, logs, and other files from your phone.\n- Download reports and artifacts the agent creates.\n- Open [session apps](docs/apps.md) from chat or the **Apps** menu: live web\n  previews, desktop app views, and CLI/TUI tools. Agents can publish views with\n  `bivy app publish bivy.app.json` and create share links with `bivy app share`.\n- Use voice input and read-aloud where supported; provider-backed voice may\n  send audio or text to the selected provider.\n- Keep a native terminal workflow or use structured chat, depending on the agent.\n\n```bash\nbivy run claude --no-follow  # start without attaching\nbivy open                    # open the web app\nbivy resume                  # return to the session in your terminal\nbivy link                    # pair a device directly via QR\n```\n\nNo phone app installation is required. Open [app.bivy.sh](https://app.bivy.sh)\nin your browser; adding it to your home screen is optional.\n\n[Remote access →](docs/remote-access.md) ·\n[Voice, files, and terminal recipes →](docs/capability-recipes.md)\n\n### Agents can reach you, too\n\nEvery session gets the `bivy` CLI, so any agent with a shell can talk back\nthrough the app, not only agents with their own built-in tools:\n\n```bash\nbivy notify \"Tests are green, PR is up\"     # chat card + phone push when you're away\nbivy ask \"Ship to staging?\" --option Yes --option No  # waits for your answer\nbivy attach report.png --caption \"Before/after\"       # show a file in the chat\nbivy suggest \"Add a dark theme to settings\"           # a next task you start in one tap\nbivy context --json                                   # session, workspace, machine, apps\n```\n\n`bivy help --json` lists every command, and with `BIVY_OUTPUT=json` failures\ncome back as structured errors with distinct exit codes, so an agent can tell\nwhat went wrong and what to run next. `bivy guide` prints short playbooks for\nagents, and the same commands are served as MCP tools for agents that prefer\nthem. Add your own standing instructions for\nevery session in **Settings → Agent instructions**.\n\n[Commands for agents inside a session →](docs/cli-reference.md#inside-an-agent-session) ·\n[Agent instructions →](docs/agent-instructions.md)\n\n## Get started\n\n### Install\n\nBivy supports **macOS and Linux with Node.js 20+**. The installer installs the\n`@bivy/bivy` package, runs guided setup, and starts a launchd or systemd service:\n\n```bash\ncurl -fsSL https://bivy.sh/install.sh | bash\n```\n\nSetup helps you choose an agent and configure remote access. Existing agents\nkeep their command, login, and configuration. The installer may use `sudo` to\ninstall a missing Node.js, but never for `npm install`. To inspect it first,\ndownload it with `curl -fsSL https://bivy.sh/install.sh -o install.sh`.\n\nAlready have Node.js and want to avoid sudo?\n\n```bash\nnpm install -g @bivy/bivy\nbivy setup\n```\n\nThen try one small task:\n\n```bash\ncd your-repo\nbivy run claude\n# Ask: \"Explain this repo and make one small, safe improvement. Run the relevant checks.\"\nbivy open\n```\n\nOpen that same session on your phone while it runs. For a web app, ask the agent\nto start its dev server, then open **Apps → Running in this workspace → Preview**.\nTry a page, point to something you'd change, and send the feedback back to the\nagent. No separate preview deployment needed.\n\nOnce that works, share a preview for review, connect another machine, or add\nyour first automation.\n\n**Local-only works too.** `bivy run`, `bivy resume`, and `bivy sessions` need no\naccount or server. Choose **local only for now** during setup; use `bivy login`\nlater. Browser and phone access need a hosted or self-hosted control plane;\nthe node itself does not serve a web UI.\n\n[Full quickstart →](docs/quickstart.md) ·\n[Installer options, service management, and uninstall →](docs/install.md)\n\n### Choose hosted or self-hosted\n\n| Option | What you get |\n|---|---|\n| **Free Cloud — $0** | Every launch feature, including automations; 10 new remote sessions per rolling seven days. No credit card required. |\n| **Cloud — $15/month** | The same features with unlimited remote sessions. |\n| **Self-hosted Core** | Operate the app, control plane, and relay yourself, with no Bivy usage limits. |\n\nManual and automated sessions share the Cloud allowance. Resuming existing\nsessions and viewing history do not consume it. Agent subscriptions and model\nprovider charges are separate. See [current pricing](https://bivy.sh#pricing).\n\n**Self-host anywhere:** deploy the public control-plane (including the web app)\nand relay images with Postgres and [a small set of environment variables](docs/deploy-images.md).\nYour server or container platform handles HTTPS. Set up owner access in the\nbrowser—no SSH, external authentication provider, or Bivy Cloud account required.\nFor a bare VPS, the [Compose installer](docs/self-host-quickstart.md) automates the\nsame stack. These onboarding features require a release containing them.\n\nStart on Cloud and self-host later if you prefer. Deploy the stack, reconnect\nmachines with `bivy relay:setup`, and pair devices to your server. This is not a\none-click migration of your Cloud account; your local repos and agent\nconfiguration stay in place.\n\n```bash\nbivy relay:setup \\\n  --control-plane https://bivy.example.com \\\n  --relay wss://relay.example.com\n```\n\nSelf-hosting is community-supported: you own TLS, backups, upgrades, and\nhardening. Public multi-architecture images are available as\n`ghcr.io/bivysh/bivy-control-plane` and `ghcr.io/bivysh/bivy-relay`; pin a release\nversion or full commit SHA.\n\n[Deploy the images anywhere →](docs/deploy-images.md) ·\n[Optional VPS installer →](docs/self-host-quickstart.md) ·\n[Operations reference →](docs/self-host.md)\n\n## Architecture\n\nYour environment, with clear security boundaries:\n\n```text\nYour machine                         Hosted or self-hosted\n┌──────────────────────┐             ┌──────────────────────┐\n│ Node daemon          │──outbound──▶│ Relay                │\n│ Agents, repos, tools │             │ Encrypted frames     │\n│ Local credentials    │             └──────────┬───────────┘\n└──────────────────────┘                        │\n                                    Browser / phone\n                                    + control plane\n                                    (app, accounts, metadata)\n```\n\n- **Execution stays on your machine.** Bivy Cloud does not run your agents.\n  Your model provider still sees whatever the agent sends it.\n- **Interactive session traffic is end-to-end encrypted** between the node and\n  paired devices. The relay forwards opaque session frames; your node dials out,\n  so no inbound public port is required.\n- **App previews have a separate security boundary.** Preview traffic uses HTTPS\n  and an outbound tunnel, not session E2E encryption. The preview ingress/relay\n  operator can see it. Public preview links grant anyone holding them access to\n  that view and its live backend until expiry or revocation. See\n  [preview security and sharing](docs/apps.md#runtime-and-security-boundaries).\n- **Ordinary credential sync uploads ciphertext, not plaintext keys.**\n  Supported credentials and recovery limits are documented separately.\n- **Encryption is not universal across integrations.** Slack commands and\n  generic webhook instructions reach the control plane in plaintext. Do not\n  put secrets in them. Routing and bounded run metadata are also visible there.\n- **Device authorization matters.** QR pairing authorizes a device directly\n  through the node. Hosted account pairing trusts the control plane to authorize\n  devices and serve the web app that holds client keys.\n- **Bivy is not an OS-level sandbox.** The default approval mode is\n  `autonomous`; protection depends on the runtime. Some agents enforce sandbox\n  tiers, while process agents may run with your full user permissions.\n  Heuristic tool checks help prevent accidents but are not isolation.\n\nReview the runtime's Protection label and configure approval/sandbox settings\nfor the task, especially before enabling unattended work.\n\n[Security model and known limitations →](docs/security-model.md) ·\n[Runtime protection matrix →](docs/runtime-support-matrix.md) ·\n[Configuration →](docs/configuration.md)\n\n## Agents and everyday commands\n\n**Claude Code, Codex, Pi, OpenCode, and Grok are release-tested.** Additional\nadapters include Gemini CLI, Qwen Code, Goose, Aider, Cline, Crush, Cursor, GitHub\nCopilot, Amp, Auggie, Droid, Continue, Kilo Code, and Rovo Dev. Installation,\nresume, model selection, and tool protection vary—see the\n[support matrix](docs/runtime-support-matrix.md) and [agent guides](docs/agents/README.md).\n\nRun an arbitrary command with `bivy run -- ./your-agent --flags`, register a\nreusable entry with `bivy agent add`, or package a declarative integration with\nexperimental [plugins](docs/plugins.md).\n\n```bash\nbivy run claude       # launch a durable session; also codex, pi, opencode\nbivy sessions         # list live and saved sessions\nbivy resume           # resume the most recent session\nbivy open             # open the web app (requires remote setup)\nbivy nodes            # list connected account machines\nbivy runs list        # inspect delegated work\nbivy automation init  # scaffold repo-owned automations\nbivy provider login   # connect supported model credentials\nbivy agent add        # register an ACP or process agent\nbivy doctor           # check installation and connectivity\nbivy logs -f          # follow node logs\nbivy update           # update and restart the service\n```\n\n`bivy update` uses your original installation method and waits for an active\nturn to finish before restarting. Use `--force` to skip that wait.\n\n[CLI reference →](docs/cli-reference.md) ·\n[Node and project configuration →](docs/config-as-code.md) ·\n[GitHub setup →](docs/github-setup.md) ·\n[Linear setup →](docs/linear-work-queue.md)\n\n## Development and contributions\n\n```bash\npnpm install\npnpm run dev          # node daemon on http://localhost:4317\npnpm run dev:web      # web client dev server\n```\n\n| Directory | Contents |\n|---|---|\n| `src/`, `bin/` | Node daemon, CLI, runtime adapters, sessions, approvals, secrets |\n| `packages/core/` | Shared protocol, pairing, and wire format |\n| `packages/web/`, `packages/ui/` | React PWA and shared design system |\n| `services/relay/` | Self-hostable encrypted relay |\n| `services/control-plane/` | Self-hostable control plane |\n| `deploy/` | Deployment examples |\n\n```bash\npnpm run typecheck\npnpm run typecheck:web\npnpm run lint\npnpm run test:unit\npnpm run test:core\npnpm run check:licenses\npnpm run check:secrets\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the development workflow. Releases\nare published from CI with provenance attestations; see\n[release verification](docs/releasing.md).\n\n**Found a security issue?** Use\n[GitHub private vulnerability reporting](https://github.com/bivysh/bivy/security/advisories/new),\nnot a public issue. See [SECURITY.md](SECURITY.md).\n\n### In development—not available at launch\n\nAutomatically provisioned, short-lived **ephemeral machines** are in development\nfor hosted and bring-your-own-cloud deployments. Neither path is ready or\nsupported for this launch. Use an existing computer or server you operate.\nExperimental provisioning has different credential-custody and encryption\nboundaries; see the [provisioning trust model](docs/hosted-provisioning-trust-model.md).\n\n## License\n\nEverything in this repository—node, CLI, web/PWA, relay, and control plane—is\nfree and open-source **AGPL-3.0-only Core**, with no Bivy usage limits. You may\nuse, modify, and self-host it under that license. If users interact with your\nmodified version over a network, section 13 requires you to offer its\ncorresponding source. See [LICENSE](LICENSE).\n\nBivy Cloud is the hosted operation of that stack plus billing and plans, in a\nseparate private repository. Contributions use the\n[DCO](CONTRIBUTING.md#certificate-of-origin); there is no CLA.\n",
+  "readme": "# Bivy\n\n[![npm](https://img.shields.io/npm/v/@bivy/bivy?color=2b6cb0&label=%40bivy%2Fbivy)](https://www.npmjs.com/package/@bivy/bivy)\n[![license: AGPL-3.0-only](https://img.shields.io/badge/license-AGPL--3.0--only-2b6cb0)](LICENSE)\n[![node](https://img.shields.io/badge/node-%E2%89%A520-2b6cb0)](https://nodejs.org)\n\n**Local coding agents that show their work. Anywhere.**\n\nBivy is the open-source workspace for coding agents. It runs Claude Code, Codex,\nPi, OpenCode and other agents on your own machine. Reach them from a browser or\nyour phone, with the live session, its terminal, its approvals, and the app\nthey're building right in the chat. Try it, mark what's wrong, and send it back.\n\n<p align=\"center\">\n  <img src=\"docs/images/preview-feedback-loop.gif\" width=\"360\"\n       alt=\"On a phone: open the app an agent built, circle the packed items, send a note, and compare the result before and after the agent's fix.\">\n</p>\n\nBivy is not another coding agent and not a cloud development machine. The agent\nstays local and does the coding with your model provider. Your repos, tools,\ndatabases, and services stay where they are. Bivy gives you remote access to all\nof it, plus live previews, automations, and review.\n\n- **Live previews.** The running app beside the chat. Mark it, send it back,\n  share it with someone who has no Bivy account.\n- **Automations.** GitHub issues, failed CI, Linear, Slack, schedules, and\n  webhooks start the work. It comes back as a preview link or a pull request.\n- **Any agent.** Hit a usage limit? Fork the session to another agent, or let\n  Bivy retry when the limit resets.\n- **Your machine, anywhere.** Start at your desk, pick the session up on your\n  phone. The machine dials out, so there are no ports to open, and session\n  traffic is end-to-end encrypted.\n\n**[Start free on Bivy Cloud](https://app.bivy.sh)** ·\n**[Quickstart](docs/quickstart.md)** ·\n**[Documentation](docs/README.md)** ·\n**[Self-host](docs/deploy-images.md)** ·\n**[Website](https://bivy.sh)**\n\n**Recommended:** sign in at [app.bivy.sh](https://app.bivy.sh), then copy your\npersonalized **Connect a Machine** command into a terminal on your Mac or Linux\ncomputer. It installs and enrolls the machine without another Bivy login. The\nbrowser connects automatically; choose a repository and send your first task\nright there.\n\nPrefer starting from the terminal?\n\n```bash\ncurl -fsSL https://bivy.sh/install.sh | bash  # install + guided setup\ncd your-repo\nbivy run claude                            # or codex, pi, opencode\nbivy open                                  # continue in the web app (needs remote setup)\n```\n\nBivy Cloud hosts the app, control plane, and relay—not the machines running your\nagents. Connect a Mac, Linux computer, or existing server and bring your own\nagent subscription, model API key, or local model. You can also self-host the\nentire remote-access stack.\n\n> **Bivy is 0.x software.** Claude Code, Codex, Pi, OpenCode, and Grok are the\n> release-tested paths. Credential sync, resume, handoffs, approvals, and\n> sandboxing depend on the runtime. See the\n> [runtime support matrix](docs/runtime-support-matrix.md).\n\n## Don't just read the diff. Try the app.\n\nBivy lets you **use what the agent built and show it what to fix**, without a\nseparate deployment step.\n\n1. **Ask for a change.** The agent works in your repo with your existing tools\n   and local services.\n2. **Try the app.** Bivy finds the dev server the agent starts and opens it\n   beside the chat: web apps, terminals, and desktop apps. Use the running app,\n   not a screenshot of what the agent says it finished.\n3. **Mark what needs work.** Press and hold anything in the preview to mark it,\n   or drag to circle it, then say what you want. **Mark another** keeps\n   separate notes separate. The marks go to the agent with the element and page\n   context. No screenshots to paste.\n4. **Follow each note.** Every mark stays in the chat as a pin that resolves\n   itself: **Changed** when a later run changes what you marked, **Element\n   gone** when it leaves the page, **Done** when you say so.\n5. **Review the next version.** A new version waits on the preview pill instead\n   of reloading under you. Take it when you're ready, compare before and after,\n   inspect the diff and checks, and decide when the work is done.\n6. **Get a second opinion.** Share a preview link for 1 hour, 1 day, or 7 days.\n   Teammates and clients try the running app and leave notes without a Bivy\n   account. Make it view-only, or **Stop sharing** to end every link at once.\n\nOn Bivy Cloud, preview delivery is built in: no per-app domains, certificates,\npublic ports, or tunnels to configure. Self-hosters configure preview delivery\nonce for their Bivy deployment, not for every app. The app still needs its normal\nbuild or dev-server setup, and **the machine serving it must stay awake and\nonline**. These are development previews, not production hosting.\n\n**Share deliberately:** anyone with a preview link can use that app, including\nits live backend, until the link expires or you stop sharing.\nReviewer notes aren't sent to the agent automatically; you send them or explicitly\nallow agent access. Preview traffic uses HTTPS through the preview relay, not\nsession end-to-end encryption; the relay operator can see it.\n\n[App previews, visual feedback, and sharing →](docs/apps.md)\n\n## One workflow, from trigger to review\n\n```text\nPrompt · GitHub issue · CI failure · Linear · Slack · Schedule · Webhook\n                                 │\n                                 ▼\n                   Choose machine + agent + model\n                     + supported credentials\n                                 │\n                                 ▼\n                         Live agent session\n                     Join · steer · approve · stop\n                                 │\n                                 ▼\n                  Try app · inspect changes · checks\n                                 │\n                                 ▼\n                  Mark up · send feedback · iterate\n                                 │\n                                 ▼\n                      Share preview · review PR\n```\n\nA **Machine** is a computer or server you connect. A **Session** is live agent\nwork on that machine. A **Run** is delegated background work that creates a\nsession and tracks its outcome. An **Automation** is a reusable definition that\ncreates runs when an event matches.\n\nManual and automated work use the same kind of live session. You can join a run\nwhen it needs help rather than wait for a black-box job to finish.\n\n### Let events start the work\n\nAutomations turn recurring or incoming work into sessions you can join,\nsupervise, and review. An agent picks the task up on your machine and posts\nback a preview link or a pull request, so you try the result where the task\nlives and reply in the same session. Choose the repository, machine, agent,\nmodel, approval mode, sandbox setting, and maximum attempts.\n\n| Trigger | Example workflow |\n|---|---|\n| **GitHub issues and mentions** | Label an issue `bivy` or `bivy/<machine>`, or mention your Bivy GitHub App, to work toward a pull request. |\n| **Failed CI** | Match a failed workflow, ask the agent to reproduce it, make a fix, and run the affected checks. |\n| **Linear** | Label an issue to start work without copying its description into an agent. |\n| **Slack** | Send a request from the conversation where the work came up. |\n| **Schedules** | Run a weekly dependency review, recurring maintenance, or a one-time task. |\n| **Signed webhooks** | Connect alerts, internal tools, or your own event sources. |\n\nConfigure automations in the app or version them with your repository in\n`.bivy/automations.yaml`:\n\n```bash\nbivy automation init\n# Edit the generated definition for your repository and workflow.\nbivy automation validate\nbivy automation test --event .bivy/events/failed-ci.yaml  # supply a local event fixture\nbivy automation apply\n```\n\nOr delegate a one-off job without creating an automation:\n\n```bash\nbivy runs start \"Review outdated dependencies and propose a small, tested update.\"\nbivy runs wait <id>\n```\n\nRuns keep routing and lifecycle evidence, check results, and output references\nin a reviewable Receipt. For unattended issue work, Bivy runs declared repository\nchecks after the agent's turn; failed required checks fail the run even if the\nagent reports success. A completed process alone is not proof that the task\nsucceeded.\n\n[Automation recipes →](docs/capability-recipes.md#let-events-start-runs) ·\n[Automations as code →](docs/automations-as-code.md) ·\n[Run outcomes and reliability limits →](docs/automation-runs.md)\n\n### Use every agent you pay for. Switch mid-task.\n\nRun Claude Code for one task, Codex for another, and Pi or OpenCode where they\nfit, side by side in one session list. Bivy supplies the shared session,\nremote-access, automation, and review surfaces; your chosen agent still does\nthe coding and uses your model provider.\n\n- **Hit a usage limit? Keep going.** When a turn fails on a limit, fork the\n  session, with its code and conversation, to another agent and model, or let\n  Bivy retry when the limit resets (the provider has to report a reset time).\n- **Get a second opinion.** `bivy delegate` hands a task to another agent, on\n  the same machine or a different one, and brings back its answer, branch, and\n  PR. `--to codex,claude@linux` sends one task to several agents to compare.\n- Choose an agent and, where supported, a model for each session or run.\n- Import existing Claude Code and Codex sessions.\n- Fork or move work to another agent or machine when a different setup fits\n  better. Continuation fidelity varies: some paths preserve native history,\n  while others replay portable turns or hand over a summary with the earlier\n  transcript as a local file.\n- Use agent-native logins, Bivy-managed credentials, or local inference.\n  Bivy's custom OpenAI-compatible endpoint registry currently feeds Pi;\n  other agents may need their own provider configuration.\n- Register your own ACP or headless process agent with `bivy agent add`.\n\nBivy does not replace your agent, provide model inference, or make every agent's\nfeatures identical. Consult the [support matrix](docs/runtime-support-matrix.md)\nand [handoff recipes](docs/capability-recipes.md#fork-or-move-a-session).\n\n### Less signing in. Less copying secrets.\n\nBivy syncs **Bivy-managed API keys and supported OAuth credentials** across\nenrolled machines for compatible runtimes. Connect supported credentials once\nand reuse them where you run work, rather than manually distributing keys to\neach machine.\n\nFor ordinary account sync, credentials are encrypted on the node before upload.\nThe control plane stores ciphertext and wrapped-key metadata; enrolled nodes\nshare access by wrapping the vault key to one another. Bivy Cloud does not\nreceive plaintext credentials through this sync path.\n\nYou can also keep credentials local, use labeled keys and project presets, or\nreference environment variables and 1Password instead of embedding secrets in\nconfiguration:\n\n```bash\nbivy provider login\nbivy credentials add anthropic work\nbivy secrets ref github.repo-token op://Bivy/GitHub/repo-token\n```\n\n**Not every CLI login syncs.** Native agent logins may still be per-machine;\nGitHub App private-key sync is separately opt-in. If you lose every node and\ndevice able to unwrap a vault, you must sign in to providers again. Explicit\nhosted-provisioning custody grants are separate from ordinary encrypted sync.\n\n[Credential sync and runtime coverage →](docs/credential-sync.md) ·\n[Credentials guide →](docs/credentials-guide.md) ·\n[Key storage →](docs/key-management.md)\n\n### Work in the environment you already have\n\nA clean cloud sandbox isn't always enough. Your agent may need the database\nrunning on localhost, an uncommitted change, an internal API behind your VPN,\nor a model running on your GPU. Bivy runs the agent where those things already\nexist, subject to that machine's permissions and the runtime's protection.\n\nConnect several machines to the same account: a laptop for interactive work,\na Linux server for background jobs, or a GPU box for local inference. Choose\nthe machine for each session or pin it in an automation. Repository runs can\nuse isolated Git worktrees without rebuilding the whole development environment.\n\n**The execution machine must stay awake and online.** To close your laptop and\nleave work running, run the agent on a different, always-on machine.\n\n[Environment and multi-machine recipes →](docs/capability-recipes.md)\n\n### Start at your desk. Continue anywhere.\n\nOpen the same session in the browser, phone PWA, or terminal. Watch work live,\nanswer questions, approve supported tool calls, or stop the agent.\n\n- Send screenshots, images, logs, and other files from your phone.\n- Download reports and artifacts the agent creates.\n- Open [session apps](docs/apps.md) from chat or the **Apps** menu: live web\n  previews, desktop app views, and CLI/TUI tools. Agents can publish views with\n  `bivy app publish bivy.app.json` and create share links with `bivy app share`.\n- Use voice input and read-aloud where supported; provider-backed voice may\n  send audio or text to the selected provider.\n- Keep a native terminal workflow or use structured chat, depending on the agent.\n\n```bash\nbivy run claude --no-follow  # start without attaching\nbivy open                    # open the web app\nbivy resume                  # return to the session in your terminal\nbivy link                    # pair a device directly via QR\n```\n\nNo phone app installation is required. Open [app.bivy.sh](https://app.bivy.sh)\nin your browser; adding it to your home screen is optional.\n\n[Remote access →](docs/remote-access.md) ·\n[Voice, files, and terminal recipes →](docs/capability-recipes.md)\n\n### Agents can reach you, too\n\nEvery session gets the `bivy` CLI, so any agent with a shell can talk back\nthrough the app, not only agents with their own built-in tools:\n\n```bash\nbivy notify \"Tests are green, PR is up\"     # chat card + phone push when you're away\nbivy ask \"Ship to staging?\" --option Yes --option No  # waits for your answer\nbivy attach report.png --caption \"Before/after\"       # show a file in the chat\nbivy suggest \"Add a dark theme to settings\"           # a next task you start in one tap\nbivy context --json                                   # session, workspace, machine, apps\n```\n\n`bivy help --json` lists every command, and with `BIVY_OUTPUT=json` failures\ncome back as structured errors with distinct exit codes, so an agent can tell\nwhat went wrong and what to run next. `bivy guide` prints short playbooks for\nagents, and the same commands are served as MCP tools for agents that prefer\nthem. Add your own standing instructions for\nevery session in **Settings → Agent instructions**.\n\n[Commands for agents inside a session →](docs/cli-reference.md#inside-an-agent-session) ·\n[Agent instructions →](docs/agent-instructions.md)\n\n## Get started\n\n### Install\n\nBivy supports **macOS and Linux with Node.js 20+**. The installer installs the\n`@bivy/bivy` package, runs guided setup, and starts a launchd or systemd service:\n\n```bash\ncurl -fsSL https://bivy.sh/install.sh | bash\n```\n\nSetup helps you choose an agent and configure remote access. Existing agents\nkeep their command, login, and configuration. The installer may use `sudo` to\ninstall a missing Node.js, but never for `npm install`. To inspect it first,\ndownload it with `curl -fsSL https://bivy.sh/install.sh -o install.sh`.\n\nAlready have Node.js and want to avoid sudo?\n\n```bash\nnpm install -g @bivy/bivy\nbivy setup\n```\n\nThen try one small task:\n\n```bash\ncd your-repo\nbivy run claude\n# Ask: \"Explain this repo and make one small, safe improvement. Run the relevant checks.\"\nbivy open\n```\n\nOpen that same session on your phone while it runs. For a web app, ask the agent\nto start its dev server, then open **Apps → Running in this workspace → Preview**.\nTry a page, point to something you'd change, and send the feedback back to the\nagent. No separate preview deployment needed.\n\nOnce that works, share a preview for review, connect another machine, or add\nyour first automation.\n\n**Local-only works too.** `bivy run`, `bivy resume`, and `bivy sessions` need no\naccount or server. Choose **local only for now** during setup; use `bivy login`\nlater. Browser and phone access need a hosted or self-hosted control plane;\nthe node itself does not serve a web UI.\n\n[Full quickstart →](docs/quickstart.md) ·\n[Installer options, service management, and uninstall →](docs/install.md)\n\n### Choose hosted or self-hosted\n\n| Option | What you get |\n|---|---|\n| **Free Cloud — $0** | Every launch feature, including automations; 10 new remote sessions per rolling seven days. No credit card required. |\n| **Cloud — $15/month** | The same features with unlimited remote sessions. |\n| **Self-hosted Core** | Operate the app, control plane, and relay yourself, with no Bivy usage limits. |\n\nManual and automated sessions share the Cloud allowance. Resuming existing\nsessions and viewing history do not consume it. Agent subscriptions and model\nprovider charges are separate. See [current pricing](https://bivy.sh#pricing).\n\n**Self-host anywhere:** deploy the public control-plane (including the web app)\nand relay images with Postgres and [a small set of environment variables](docs/deploy-images.md).\nYour server or container platform handles HTTPS. Set up owner access in the\nbrowser—no SSH, external authentication provider, or Bivy Cloud account required.\nFor a bare VPS, the [Compose installer](docs/self-host-quickstart.md) automates the\nsame stack. These onboarding features require a release containing them.\n\nStart on Cloud and self-host later if you prefer. Deploy the stack, reconnect\nmachines with `bivy relay:setup`, and pair devices to your server. This is not a\none-click migration of your Cloud account; your local repos and agent\nconfiguration stay in place.\n\n```bash\nbivy relay:setup \\\n  --control-plane https://bivy.example.com \\\n  --relay wss://relay.example.com\n```\n\nSelf-hosting is community-supported: you own TLS, backups, upgrades, and\nhardening. Public multi-architecture images are available as\n`ghcr.io/bivysh/bivy-control-plane` and `ghcr.io/bivysh/bivy-relay`; pin a release\nversion or full commit SHA.\n\n[Deploy the images anywhere →](docs/deploy-images.md) ·\n[Optional VPS installer →](docs/self-host-quickstart.md) ·\n[Operations reference →](docs/self-host.md)\n\n## Architecture\n\nYour environment, with clear security boundaries:\n\n```text\nYour machine                         Hosted or self-hosted\n┌──────────────────────┐             ┌──────────────────────┐\n│ Node daemon          │──outbound──▶│ Relay                │\n│ Agents, repos, tools │             │ Encrypted frames     │\n│ Local credentials    │             └──────────┬───────────┘\n└──────────────────────┘                        │\n                                    Browser / phone\n                                    + control plane\n                                    (app, accounts, metadata)\n```\n\n- **Execution stays on your machine.** Bivy Cloud does not run your agents.\n  Your model provider still sees whatever the agent sends it.\n- **Interactive session traffic is end-to-end encrypted** between the node and\n  paired devices. The relay forwards opaque session frames; your node dials out,\n  so no inbound public port is required.\n- **App previews have a separate security boundary.** Preview traffic uses HTTPS\n  and an outbound tunnel, not session E2E encryption. The preview ingress/relay\n  operator can see it. Public preview links grant anyone holding them access to\n  that view and its live backend until expiry or revocation. See\n  [preview security and sharing](docs/apps.md#runtime-and-security-boundaries).\n- **Ordinary credential sync uploads ciphertext, not plaintext keys.**\n  Supported credentials and recovery limits are documented separately.\n- **Encryption is not universal across integrations.** Slack commands and\n  generic webhook instructions reach the control plane in plaintext. Do not\n  put secrets in them. Routing and bounded run metadata are also visible there.\n- **Device authorization matters.** QR pairing authorizes a device directly\n  through the node. Hosted account pairing trusts the control plane to authorize\n  devices and serve the web app that holds client keys.\n- **Bivy is not an OS-level sandbox.** The default approval mode is\n  `autonomous`; protection depends on the runtime. Some agents enforce sandbox\n  tiers, while process agents may run with your full user permissions.\n  Heuristic tool checks help prevent accidents but are not isolation.\n\nReview the runtime's Protection label and configure approval/sandbox settings\nfor the task, especially before enabling unattended work.\n\n[Security model and known limitations →](docs/security-model.md) ·\n[Runtime protection matrix →](docs/runtime-support-matrix.md) ·\n[Configuration →](docs/configuration.md)\n\n## Agents and everyday commands\n\n**Claude Code, Codex, Pi, OpenCode, and Grok are release-tested.** Additional\nadapters include Gemini CLI, Qwen Code, Goose, Aider, Cline, Crush, Cursor, GitHub\nCopilot, Amp, Auggie, Droid, Continue, Kilo Code, and Rovo Dev. Installation,\nresume, model selection, and tool protection vary—see the\n[support matrix](docs/runtime-support-matrix.md) and [agent guides](docs/agents/README.md).\n\nRun an arbitrary command with `bivy run -- ./your-agent --flags`, register a\nreusable entry with `bivy agent add`, or package a declarative integration with\nexperimental [plugins](docs/plugins.md).\n\n```bash\nbivy run claude       # launch a durable session; also codex, pi, opencode\nbivy sessions         # list live and saved sessions\nbivy resume           # resume the most recent session\nbivy open             # open the web app (requires remote setup)\nbivy nodes            # list connected account machines\nbivy runs list        # inspect delegated work\nbivy automation init  # scaffold repo-owned automations\nbivy provider login   # connect supported model credentials\nbivy agent add        # register an ACP or process agent\nbivy doctor           # check installation and connectivity\nbivy logs -f          # follow node logs\nbivy update           # update and restart the service\n```\n\n`bivy update` uses your original installation method and waits for an active\nturn to finish before restarting. Use `--force` to skip that wait.\n\n[CLI reference →](docs/cli-reference.md) ·\n[Node and project configuration →](docs/config-as-code.md) ·\n[GitHub setup →](docs/github-setup.md) ·\n[Linear setup →](docs/linear-work-queue.md)\n\n## Development and contributions\n\n```bash\npnpm install\npnpm run dev          # node daemon on http://localhost:4317\npnpm run dev:web      # web client dev server\n```\n\n| Directory | Contents |\n|---|---|\n| `src/`, `bin/` | Node daemon, CLI, runtime adapters, sessions, approvals, secrets |\n| `packages/core/` | Shared protocol, pairing, and wire format |\n| `packages/web/`, `packages/ui/` | React PWA and shared design system |\n| `services/relay/` | Self-hostable encrypted relay |\n| `services/control-plane/` | Self-hostable control plane |\n| `deploy/` | Deployment examples |\n\n```bash\npnpm run typecheck\npnpm run typecheck:web\npnpm run lint\npnpm run test:unit\npnpm run test:core\npnpm run check:licenses\npnpm run check:secrets\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the development workflow. Releases\nare published from CI with provenance attestations; see\n[release verification](docs/releasing.md).\n\n**Found a security issue?** Use\n[GitHub private vulnerability reporting](https://github.com/bivysh/bivy/security/advisories/new),\nnot a public issue. See [SECURITY.md](SECURITY.md).\n\n### In development—not available at launch\n\nAutomatically provisioned, short-lived **ephemeral machines** are in development\nfor hosted and bring-your-own-cloud deployments. Neither path is ready or\nsupported for this launch. Use an existing computer or server you operate.\nExperimental provisioning has different credential-custody and encryption\nboundaries; see the [provisioning trust model](docs/hosted-provisioning-trust-model.md).\n\n## License\n\nEverything in this repository—node, CLI, web/PWA, relay, and control plane—is\nfree and open-source **AGPL-3.0-only Core**, with no Bivy usage limits. You may\nuse, modify, and self-host it under that license. If users interact with your\nmodified version over a network, section 13 requires you to offer its\ncorresponding source. See [LICENSE](LICENSE).\n\nBivy Cloud is the hosted operation of that stack plus billing and plans, in a\nseparate private repository. Contributions use the\n[DCO](CONTRIBUTING.md#certificate-of-origin); there is no CLA.\n",
   "readmeFilename": "README.md",
   "agentBridges": {
     "@anthropic-ai/claude-agent-sdk": "0.3.285",