@saadnvd1/agent-os 0.3.765 → 0.3.768

package/README.md

@@ -50,7 +50,7 @@ and check on all of it from your phone.
 
 The iPhone app, [AgentOS: Coding Agents](https://apps.apple.com/us/app/agentos-coding-agents/id6820980797), is on the App Store.
 
-You need Node.js 22+, tmux, and at least one agent CLI (the installer offers to set up what's missing).
+You need Node.js 22+, git, tmux, and at least one agent CLI (the installer offers to set up what's missing).
 
 ```bash
 npm install -g @saadnvd1/agent-os
@@ -69,11 +69,12 @@ Then open AgentOS, add a project from ⌘K, and press ⌥N. The [install guide](
 
 ## Connect
 
-Connect (in development) lets you reach AgentOS from anywhere, without a tailnet or opening a port. Sign in at [runagentos.com](https://runagentos.com), get a code, and run:
+AgentOS Connect is live. It gives your machine a private address at runagentos.com, so your phone reaches it from any network with nothing to open on your router and no VPN.
 
-```bash
-agent-os connect   # links this machine with the code from runagentos.com
-```
+- **Free ($0):** Connect for one machine, including phone access from anywhere, on up to 3 devices.
+- **Pro ($4/mo billed yearly, or $6 monthly):** link up to 10 machines, with unlimited devices and 100 GB of traffic a month.
+
+[Sign up](https://runagentos.com/sign-in?mode=sign-up), then run `agent-os connect` on the machine and enter the code. The [phone guide](docs/guides/phone.md) has the steps.
 
 Reach it from your phone with the [AgentOS iPhone app](https://apps.apple.com/us/app/agentos-coding-agents/id6820980797), now on the App Store.
 

package/components/DemoNotice.tsx

@@ -1,4 +1,8 @@
 import { Info } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { CONNECT_SIGN_UP } from "@/lib/connect/view";
+
+const INSTALL_URL = "https://github.com/saadnvd1/agent-os#install";
 
 // Where a terminal or a new session would be, in a demo: what this is and
 // what to look at instead. Fixed text; nothing runs.
@@ -18,6 +22,18 @@ export function DemoNotice() {
           Open a session from the sidebar to read its chat, its changes and its
           pull request; its terminal stays closed.
         </p>
+        <div className="flex flex-wrap gap-2 pt-1">
+          <Button asChild className="min-h-11 sm:min-h-9">
+            <a href={INSTALL_URL} target="_blank" rel="noopener noreferrer">
+              Install AgentOS
+            </a>
+          </Button>
+          <Button asChild variant="outline" className="min-h-11 sm:min-h-9">
+            <a href={CONNECT_SIGN_UP} target="_blank" rel="noopener noreferrer">
+              Get Connect
+            </a>
+          </Button>
+        </div>
       </div>
     </div>
   );

package/components/Devices/ConnectCard.tsx

@@ -3,7 +3,11 @@
 import { Cloud } from "lucide-react";
 import { Switch } from "@/components/ui/switch";
 import type { ConnectStatus } from "@/lib/connect/serve";
-import { CONNECT_STATE as STATE, connectView } from "@/lib/connect/view";
+import {
+  CONNECT_SIGN_UP,
+  CONNECT_STATE as STATE,
+  connectView,
+} from "@/lib/connect/view";
 
 export function ConnectCard({
   connect,
@@ -38,7 +42,21 @@ export function ConnectCard({
           ) : enrolled ? (
             <>Linked. The address appears once the tunnel starts.</>
           ) : (
-            <>Not set up on this machine. Run agent-os connect in a terminal.</>
+            <>
+              Not set up on this machine. Run{" "}
+              <code className="text-foreground font-mono">
+                agent-os connect
+              </code>{" "}
+              in a terminal.{" "}
+              <a
+                href={CONNECT_SIGN_UP}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-foreground flex min-h-11 w-fit items-center underline underline-offset-2 sm:min-h-6"
+              >
+                Set up Connect (free)
+              </a>
+            </>
           )}
           {connect.reason && connect.state !== "off"
             ? ` ${connect.reason.replace(/\.$/, "")}.`

package/components/Models/ProviderCard.tsx

@@ -73,7 +73,7 @@ export function ProviderCard({
   const builtIn = provider.id === ANTHROPIC;
   const [open, setOpen] = useState(false);
   const [kind, setKind] = useState<SecretRef["kind"]>(
-    provider.auth?.kind ?? "tokenvault"
+    provider.auth?.kind ?? "env"
   );
   const [a0, b0] = refFields(provider.auth);
   const [a, setA] = useState(a0);

package/components/SessionList/SidebarBody.tsx

@@ -3,6 +3,7 @@
 import { AlertCircle, FolderPlus, Plus, X } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { ShimmeringLoader } from "@/components/ui/skeleton";
+import { chordHint } from "@/lib/keybindings/chord";
 import { sidebarUiActions } from "@/stores/sidebarUi";
 import type { SidebarData } from "./useSidebarData";
 import { MachineShelves, SessionShelves } from "./SessionShelves";
@@ -99,10 +100,19 @@ export function SidebarBody({
           <Empty
             text="Create a project to start your first session"
             action={
-              <Button onClick={onNewProject} className="h-11 gap-2 md:h-9">
-                <FolderPlus className="h-4 w-4" />
-                Add project
-              </Button>
+              <div className="flex flex-col items-center gap-3">
+                <Button onClick={onNewProject} className="h-11 gap-2 md:h-9">
+                  <FolderPlus className="h-4 w-4" />
+                  Add project
+                </Button>
+                <p className="text-muted-foreground/70 text-xs">
+                  Then press{" "}
+                  <kbd className="bg-muted text-foreground rounded px-1.5 py-0.5 font-mono">
+                    {chordHint("alt+n")}
+                  </kbd>{" "}
+                  to start a session
+                </p>
+              </div>
             }
           />
         ) : (

package/components/Welcome/ConnectBlock.tsx

@@ -13,7 +13,11 @@ import {
   useNetworkQuery,
   useUpdateNetwork,
 } from "@/data/devices";
-import { CONNECT_SITE, CONNECT_STATE, connectView } from "@/lib/connect/view";
+import {
+  CONNECT_SIGN_UP,
+  CONNECT_STATE,
+  connectView,
+} from "@/lib/connect/view";
 import { Block } from "./Block";
 
 const COMMAND = "agent-os connect";
@@ -40,7 +44,7 @@ export function LinkForm() {
       <p className="text-muted-foreground text-xs">
         Get a code at{" "}
         <a
-          href={CONNECT_SITE}
+          href={CONNECT_SIGN_UP}
           target="_blank"
           rel="noopener noreferrer"
           className="text-foreground inline-flex items-center gap-1 underline underline-offset-2"
@@ -48,7 +52,7 @@ export function LinkForm() {
           runagentos.com
           <ExternalLink className="size-3" />
         </a>{" "}
-        (Connect a machine), then paste it here.
+        (free account, then Connect a machine), then paste it here.
       </p>
       <form
         className="flex gap-2"
@@ -104,7 +108,7 @@ export function ConnectBlock() {
     <Block
       icon={Globe}
       title="Use it away from home"
-      detail="Connect gives this machine a private address at runagentos.com, so your phone reaches it from anywhere. Nothing to open on your router."
+      detail="Connect is free for one machine. It gives this machine a private address at runagentos.com, so your phone reaches it from anywhere. Nothing to open on your router."
     >
       {network.isPending ? (
         <div className="bg-muted/40 h-12 animate-pulse rounded-lg" />

package/components/Welcome/WelcomeDialog.tsx

@@ -28,7 +28,7 @@ const STEPS: Record<
   agents: {
     label: "Agents",
     title: "Connect your agents",
-    hint: "Install and sign in the coding agents you want to use. You need one.",
+    hint: "Install and sign in the coding agents you want to use. You need one, with an account such as Claude or Codex.",
   },
   project: {
     label: "Project",

package/lib/connect/view.ts

@@ -1,6 +1,7 @@
 import type { ConnectStatus } from "./serve";
 
 export const CONNECT_SITE = "https://runagentos.com";
+export const CONNECT_SIGN_UP = `${CONNECT_SITE}/sign-in?mode=sign-up`;
 
 export const CONNECT_STATE: Record<ConnectStatus["state"], string> = {
   up: "Connected",

package/lib/tasks/contract/plan.ts

@@ -25,7 +25,7 @@ import { getProject } from "../../projects";
 import { planFor, splitOf } from "../../plans/features";
 import { moveTask } from "../move-flow";
 import * as client from "./client";
-import { meetsNeeds, needsOf } from "../placement";
+import { meetsNeeds, needsOf, taskPinnedToMac } from "../placement";
 import { remotePlanPath } from "./plan-path";
 import { DEFAULT_PRIORITY, isPriority } from "../schedule-types";
 import { localHolds } from "../hold-checks";
@@ -55,6 +55,9 @@ function checkedSplit(s: Session, text: string | null) {
   }
 }
 
+const pinned = (s: Session, project: { working_directory: string }) =>
+  taskPinnedToMac(s.id, expandHome(project.working_directory));
+
 /**
  * Where a written plan is built: "there" (approved on the machine that
  * planned it) or "home" (moved here first). Pieces are checked against this
@@ -70,6 +73,9 @@ export function implementTarget(
   // The project lives there: nothing here to build it in.
   if (!project || isRemoteHost(project.host_id)) return "there";
   if (split) return "home";
+  // An explicit Mac pin builds on the Mac, wherever the plan ran.
+  if (pinned(s, project))
+    return meetsNeeds(["mac"], machineCapabilities()) ? "home" : "there";
   const { needs } = needsOf({
     projectId: project.id,
     projectPath: expandHome(project.working_directory),
@@ -229,6 +235,7 @@ export async function handoffHome(
     projectPath: expandHome(project.working_directory),
     prompt: s.task_prompt ?? "",
   });
+  if (pinned(s, project) && !needs.includes("mac")) needs.push("mac");
   const holds = localHolds(
     {
       needs,

package/lib/tasks/placement.ts

@@ -79,6 +79,28 @@ export function inferNeeds(projectPath: string): Need[] {
   return [];
 }
 
+// Whether the starter asked for a Mac outright: the request's `machine`
+// (stored on the queue row, which shares the task's id), a recipe's, or the
+// project's own machine setting. A need read from the brief or the files
+// doesn't count: that one a plan can ignore.
+export function pinnedToMac(
+  stored: string | null,
+  projectPath: string
+): boolean {
+  const asked = parseNeeds(stored);
+  if (asked) return asked.includes("mac");
+  return !!loadProjectConfig(projectPath).config.machine?.needs?.includes(
+    "mac"
+  );
+}
+
+export function taskPinnedToMac(taskId: string, projectPath: string): boolean {
+  const row = db
+    .prepare(`SELECT machine_needs FROM task_queue WHERE id = ?`)
+    .get(taskId) as { machine_needs: string | null } | undefined;
+  return pinnedToMac(row?.machine_needs ?? null, projectPath);
+}
+
 export function needsOf(input: {
   projectId: string;
   projectPath: string;

package/lib/tasks/queue-placement.ts

@@ -13,6 +13,7 @@ import { usesGitCrypt } from "../worktree-add";
 import { list as hostTasks } from "./contract/client";
 import {
   asPlanPhase,
+  pinnedToMac,
   place,
   unplaceable,
   wantsPlacing,
@@ -90,11 +91,22 @@ async function peerOptions(
   return out;
 }
 
-// A start that plans first goes by its plan phase: it needs no Mac or
-// simulator, and a plan-only one that no machine can take starts here
+// A start that plans first goes by its plan phase: it needs no simulator, and a plan-only one that no machine can take starts here
 // as ever (it never waits on load).
 const plansFirst = (r: QueueRow) => !!(r.plan || r.plan_only);
 
+// Planning needs no simulator or Xcode, and a need read from the files or the
+// brief doesn't hold it. Only an explicit Mac pin does: the work is Mac-only
+// (often because the other machine can't reach what it touches).
+const planNeeds = (r: QueueRow, needs: Need[]): Need[] => {
+  const project = getProject(r.project_id);
+  return project &&
+    needs.includes("mac") &&
+    pinnedToMac(r.machine_needs, expandHome(project.working_directory))
+    ? ["mac"]
+    : [];
+};
+
 // Marks each start the home machine's load rules out as remote and returns
 // where it goes. "stale": the line moved while the machines were asked, so
 // this look is over, and the one a change during it asks for sees the line
@@ -143,7 +155,7 @@ export async function placeCandidates(
       asked(c),
       home,
       options,
-      plan ? [] : (needsOf.get(c.id) ?? []),
+      plan ? planNeeds(r, needsOf.get(c.id) ?? []) : (needsOf.get(c.id) ?? []),
       now
     );
     if (!spot) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.765",
+  "version": "0.3.768",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"