feat: unify Free session and host management

Author: kilingzhang

.gitignore

@@ -2,6 +2,7 @@ node_modules/
 dist/
 dist-bin/
 .tmp/
+.playwright-mcp/
 .expo/
 
 relay/node_modules/

README.md

@@ -17,13 +17,13 @@ curl -fsSL https://free.saaskit.app/install | bash
 ```
 
 The binary installer downloads the current GitHub `latest` release asset for
-your platform, installs it to `~/.local/bin/free`, then runs `free auth login`
-by default.
+your platform, installs the unified `free` CLI to `~/.local/bin/free`, then runs
+`free login` by default.
 
 Useful binary install flags:
 
 - `--no-login` installs only the `free` CLI.
-- `--force-login` refreshes browser login and reinstalls the active host mode.
+- `--force-login` refreshes browser login and re-enables this machine.
 - `--relay-env local` signs in against the local relay.
 - `--relay-url <ws-url>` uses a custom relay.
 
@@ -35,12 +35,12 @@ curl -fsSL https://raw.githubusercontent.com/saaskit-dev/Free/main/scripts/insta
 
 The source installer clones Free and `acp-runtime`, builds the required local
 packages, packs Free, installs the resulting CLI globally with npm, then runs
-`free auth login` by default.
+`free login` by default.
 
 Useful source install flags:
 
 - `--no-login` installs only the `free` CLI.
-- `--force-login` refreshes browser login and reinstalls the active host mode.
+- `--force-login` refreshes browser login and re-enables this machine.
 - `--relay-url <ws-url>` uses a non-default relay.
 - `--ref <git-ref>` installs a specific Free branch, tag, or commit.
 
@@ -55,17 +55,18 @@ For a local checkout:
 The installed package exposes `free`:
 
 ```sh
-free auth login
-free auth status
-free auth logout
-free bridge run
-free bridge config
+free login
+free logout
+free status
+free session list
+free session close <session-id>
 ```
 
 The normal user flow is:
 
-1. Run `free auth login` on each machine that should host agents.
-2. Configure the editor ACP client to launch `free bridge run`.
+1. Install the unified `free` CLI.
+2. Run `free login` on each machine that should be available.
+3. Check availability with `free status`.
 
 Hosts are registered in the relay control plane. Offline hosts can still appear
 in discovery using their last known metadata, but only currently connected hosts
@@ -202,19 +203,21 @@ Workbench.
 The default bridge, auth, and host environment is online:
 
 ```sh
-free bridge config
-free bridge run
-free auth login
+free login
+free status
 ```
 
 Use the local environment when testing against `make relay-dev` on port `8791`
 and Workbench Web on port `8790`:
 
 ```sh
-free bridge config --relay-env local
-free bridge run --relay-env local
-free auth login --relay-env local
+free login --relay-env local
+free status --relay-env local
 ```
 
+The online host and local test host use separate launchd services, so both can
+run at the same time. `free logout --relay-env local` stops only the local test
+host; plain `free logout` targets the default online host.
+
 `--relay-url <ws-url>` remains available for custom relay deployments, but it
 should not be mixed with `--relay-env`.

apps/workbench/src/App.tsx

@@ -14,7 +14,7 @@ import { colors, typography } from "./ui/theme";
 
 export default function App() {
   const [route, setRoute] = useState<RouteId>(readWorkbenchRouteFromLocation());
-  const { preferences, setLanguage, setTheme } = useWorkbenchPreferences();
+  const { preferences, setLanguage, setSidebar, setTheme } = useWorkbenchPreferences();
   const [fontsLoaded] = useFonts({
     BricolageGrotesqueBold: require("../assets/fonts/BricolageGrotesque-Bold.ttf"),
     IBMPlexMono: require("../assets/fonts/IBMPlexMono-Regular.ttf"),
@@ -95,6 +95,7 @@ export default function App() {
         route={route}
         setLanguage={setLanguage}
         setRoute={setRoute}
+        setSidebar={setSidebar}
         setTheme={setTheme}
       />
     </>

apps/workbench/src/api/relay.ts

@@ -258,6 +258,26 @@ export async function loadSessions() {
   return readJsonResult<{ sessions: SessionRecord[] }>("/api/sessions");
 }
 
+export async function closeSession(sessionId: string) {
+  const response = await fetch(`${defaultRelayUrl()}/api/sessions/${encodeURIComponent(sessionId)}`, {
+    credentials: "include",
+    headers: {
+      accept: "application/json",
+    },
+    method: "DELETE",
+  });
+  const value = (await response.json().catch(() => null)) as { error?: unknown; reason?: unknown } | null;
+  if (!response.ok) {
+    throw new Error(
+      value && typeof value === "object" && typeof value.error === "string"
+        ? value.error
+        : value && typeof value === "object" && typeof value.reason === "string"
+          ? value.reason
+          : `Request failed with ${response.status}.`,
+    );
+  }
+}
+
 export async function checkSessionHealth() {
   return readJsonResult<SessionHealth>("/api/sessions/health");
 }

apps/workbench/src/features/access/AccessScreen.tsx

@@ -1,5 +1,6 @@
 import { GithubIcon, Login03Icon } from "@hugeicons/core-free-icons";
-import { Pressable, Text, View } from "react-native";
+import { useState } from "react";
+import { ActivityIndicator, Pressable, Text, View } from "react-native";
 
 import { createLoginUrl, currentWorkbenchUrl } from "../../api/relay";
 import type { AccountSession, LanguageMode, LoadState } from "../../types";
@@ -13,6 +14,8 @@ type AccessScreenProps = {
 };
 
 export function AccessScreen({ language, session }: AccessScreenProps) {
+  const [openingLogin, setOpeningLogin] = useState(false);
+
   if (session.status === "loading") {
     return (
       <StatePanel
@@ -34,12 +37,27 @@ export function AccessScreen({ language, session }: AccessScreenProps) {
           )}
         />
         <Pressable
-          onPress={() => navigateToLogin(createLoginUrl(currentWorkbenchUrl()))}
-          style={[common.panel, { alignItems: "center", backgroundColor: colors.lime, flexDirection: "row", gap: 12, padding: 16 }]}
+          accessibilityState={openingLogin ? { busy: true, disabled: true } : undefined}
+          disabled={openingLogin}
+          onPress={() => {
+            setOpeningLogin(true);
+            setTimeout(() => {
+              navigateToLogin(createLoginUrl(currentWorkbenchUrl()));
+            }, 120);
+          }}
+          style={[
+            common.panel,
+            { alignItems: "center", backgroundColor: colors.lime, flexDirection: "row", gap: 12, padding: 16 },
+            openingLogin ? { opacity: 0.65 } : null,
+          ]}
         >
-          <Icon icon={GithubIcon} size={22} />
+          {openingLogin ? (
+            <ActivityIndicator color={colors.ink} size="small" />
+          ) : (
+            <Icon icon={GithubIcon} size={22} />
+          )}
           <Text style={{ color: colors.ink, fontFamily: typography.sansSemi, fontSize: 16 }}>
-            {t(language, "使用 GitHub 登录", "Sign in with GitHub")}
+            {openingLogin ? t(language, "正在打开登录", "Opening sign in") : t(language, "使用 GitHub 登录", "Sign in with GitHub")}
           </Text>
           <Icon icon={Login03Icon} size={20} />
         </Pressable>