feat(interface): responsive mobile-friendly layout for the dashboard (#601)

interface/src/components/MobileTopBar.tsx

@@ -0,0 +1,43 @@
+import {List} from "@phosphor-icons/react";
+import clsx from "clsx";
+import type {ReactNode} from "react";
+
+interface MobileTopBarProps {
+	title?: string;
+	onMenu: () => void;
+	leading?: ReactNode;
+	trailing?: ReactNode;
+	className?: string;
+}
+
+export function MobileTopBar({
+	title,
+	onMenu,
+	leading,
+	trailing,
+	className,
+}: MobileTopBarProps) {
+	return (
+		<header
+			className={clsx(
+				"flex h-12 shrink-0 items-center gap-2 border-b border-app-line bg-sidebar px-2",
+				className,
+			)}
+		>
+			{leading ?? (
+				<button
+					type="button"
+					aria-label="Open menu"
+					onClick={onMenu}
+					className="flex h-11 w-11 items-center justify-center rounded-lg text-ink hover:bg-app-box/60 active:bg-app-box/80"
+				>
+					<List size={20} weight="regular" />
+				</button>
+			)}
+			<div className="min-w-0 flex-1 truncate text-sm font-medium text-ink">
+				{title}
+			</div>
+			{trailing && <div className="flex items-center gap-1">{trailing}</div>}
+		</header>
+	);
+}

interface/src/components/OpenCodeEmbed.tsx

@@ -218,6 +218,9 @@ export function OpenCodeEmbed({
 
 				// Pre-seed OpenCode layout preferences so it starts with a clean
 				// chat-only view (sidebar, terminal, file tree, review all closed).
+				// `session.width` is intentionally omitted so OpenCode picks a width
+				// suitable for the current viewport — seeding a fixed 600px broke
+				// the native mobile layout at narrow widths.
 				const layoutKey = "opencode.global.dat:layout";
 				if (!localStorage.getItem(layoutKey)) {
 					localStorage.setItem(
@@ -232,7 +235,6 @@ export function OpenCodeEmbed({
 							terminal: {height: 280, opened: false},
 							review: {diffStyle: "split", panelOpened: false},
 							fileTree: {opened: false, width: 344, tab: "changes"},
-							session: {width: 600},
 							mobileSidebar: {opened: false},
 							sessionTabs: {},
 							sessionView: {},
@@ -261,12 +263,14 @@ export function OpenCodeEmbed({
 				style.textContent = cssText;
 				shadow.appendChild(style);
 
-				// Hide the sidebar, mobile sidebar, and top bar in embedded
-				// mode — we only want the session/chat view.
+				// Hide OpenCode's desktop nav + title chrome — spacebot provides
+				// its own. The mobile nav (`sidebar-nav-mobile`) is intentionally
+				// NOT hidden: when the viewport drops below md, OpenCode's
+				// internal responsive layout surfaces it, and we want users to
+				// have a way to switch sessions inside the embed on phones.
 				const overrides = document.createElement("style");
 				overrides.textContent = `
 					[data-component="sidebar-nav-desktop"],
-					[data-component="sidebar-nav-mobile"],
 					header:has(#opencode-titlebar-center),
 					[data-session-title] { display: none !important; }
 					main { border: none !important; border-radius: 0 !important; }

interface/src/components/Sidebar.tsx

@@ -62,6 +62,8 @@ import {IS_DESKTOP, IS_MACOS} from "@/platform";
 
 interface SidebarProps {
 	liveStates: Record<string, ChannelLiveState>;
+	/** When true, drop the fixed 220px width — sidebar fills its drawer container. */
+	fillWidth?: boolean;
 }
 
 const agentSubItems = [
@@ -185,7 +187,10 @@ function readProjectId(search: unknown): string | null {
 	return typeof id === "string" ? id : null;
 }
 
-export function Sidebar({liveStates: _liveStates}: SidebarProps) {
+export function Sidebar({
+	liveStates: _liveStates,
+	fillWidth = false,
+}: SidebarProps) {
 	const navigate = useNavigate();
 	const [createOpen, setCreateOpen] = useState(false);
 	const [userExpandedAgent, setUserExpandedAgent] = useState<string | null>(
@@ -273,7 +278,13 @@ export function Sidebar({liveStates: _liveStates}: SidebarProps) {
 	};
 
 	return (
-		<aside className="flex w-[220px] shrink-0 flex-col bg-sidebar">
+		<aside
+			className={
+				fillWidth
+					? "flex h-full w-full shrink-0 flex-col bg-sidebar"
+					: "flex w-[220px] shrink-0 flex-col bg-sidebar"
+			}
+		>
 			{/* Company switcher */}
 			<div className={`px-3 ${IS_DESKTOP && IS_MACOS ? "pt-[50px]" : "pt-3"}`}>
 				<Popover.Root open={switcherOpen} onOpenChange={setSwitcherOpen}>

interface/src/components/agent-config/ConfigSidebar.tsx

@@ -15,7 +15,7 @@ export function ConfigSidebar({
 	identityData,
 }: ConfigSidebarProps) {
 	return (
-		<div className="flex w-52 flex-shrink-0 flex-col border-r border-app-line/50 bg-app-dark-box/20 overflow-y-auto">
+		<div className="flex w-full flex-shrink-0 flex-col overflow-y-auto md:w-52 md:border-r md:border-app-line/50 md:bg-app-dark-box/20">
 			{/* General Group */}
 			<div className="flex flex-col gap-0.5 px-2 pt-3">
 				{SECTIONS.filter((s) => s.group === "general").map((section) => (

interface/src/components/skills/SkillInspector.tsx

@@ -92,7 +92,7 @@ export function SkillInspector({
 		selected.type === "installed" ? installedContentQuery.data?.base_dir : null;
 
 	return (
-		<div className="flex w-80 flex-shrink-0 flex-col border-l border-app-line/50 bg-app-dark-box/10">
+		<div className="flex h-full w-full flex-shrink-0 flex-col md:w-80 md:border-l md:border-app-line/50 md:bg-app-dark-box/10">
 			{/* Header */}
 			<div className="flex items-start justify-between gap-2 border-b border-app-line/50 px-4 py-3">
 				<div className="min-w-0 flex-1">

interface/src/components/skills/SkillsSidebar.tsx

@@ -42,7 +42,7 @@ export function SkillsSidebar({
 		selectedSkill?.type === "installed" ? selectedSkill.skill.name : null;
 
 	return (
-		<div className="flex w-52 flex-shrink-0 flex-col border-r border-app-line/50 bg-app-dark-box/20">
+		<div className="flex w-full flex-shrink-0 flex-col md:w-52 md:border-r md:border-app-line/50 md:bg-app-dark-box/20">
 			{/* Top actions */}
 			<div className="flex flex-col gap-0.5 px-2 pt-3">
 				{TOP_VIEWS.map(({view, label, icon: Icon}) => (

interface/src/components/workbench/WorkbenchSidebar.tsx

@@ -6,13 +6,21 @@ export function WorkbenchSidebar({
 	tree,
 	totalCount,
 	onSelectWorker,
+	fillWidth = false,
 }: {
 	tree: ProjectGroup[];
 	totalCount: number;
 	onSelectWorker: (id: string) => void;
+	fillWidth?: boolean;
 }) {
 	return (
-		<aside className="flex h-full w-[270px] flex-shrink-0 flex-col overflow-hidden rounded-2xl border border-app-line bg-app">
+		<aside
+			className={
+				fillWidth
+					? "flex h-full w-full flex-col overflow-hidden bg-sidebar"
+					: "flex h-full w-[270px] flex-shrink-0 flex-col overflow-hidden rounded-2xl border border-app-line bg-app"
+			}
+		>
 			<div className="flex h-[60px] flex-col justify-center gap-0.5 border-b border-app-line px-3 pt-1">
 				<h2 className="text-xs font-medium text-ink">Workbench</h2>
 				<div className="text-tiny text-ink-faint">

interface/src/components/workbench/WorkerColumn.tsx

@@ -14,7 +14,7 @@ export function WorkerColumn({worker}: {worker: OrchestrationWorker}) {
 	const taskText = worker.task.replace(/^\[opencode\]\s*/i, "");
 
 	return (
-		<div className="flex h-full w-[560px] flex-shrink-0 flex-col overflow-hidden rounded-2xl border border-app-line bg-app-box">
+		<div className="flex h-full w-full flex-shrink-0 snap-center flex-col overflow-hidden rounded-2xl border border-app-line bg-app-box md:w-[560px] md:snap-none">
 			{/* Column header */}
 			<div className="flex flex-col gap-1 h-[60px] border-b border-app-line px-3 py-2">
 				<div className="flex items-center gap-2">

interface/src/hooks/useMediaQuery.ts

@@ -0,0 +1,25 @@
+import {useEffect, useState} from "react";
+
+export function useMediaQuery(query: string): boolean {
+	const getMatch = () => {
+		if (typeof window === "undefined") return false;
+		return window.matchMedia(query).matches;
+	};
+
+	const [matches, setMatches] = useState<boolean>(getMatch);
+
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const mql = window.matchMedia(query);
+		const handler = (e: MediaQueryListEvent) => setMatches(e.matches);
+		setMatches(mql.matches);
+		mql.addEventListener("change", handler);
+		return () => mql.removeEventListener("change", handler);
+	}, [query]);
+
+	return matches;
+}
+
+export function useIsMobile(): boolean {
+	return useMediaQuery("(max-width: 767px)");
+}

interface/src/router.tsx

@@ -1,3 +1,4 @@
+import {useEffect, useState} from "react";
 import {
 	createRouter,
 	createRootRoute,
@@ -7,7 +8,10 @@ import {
 } from "@tanstack/react-router";
 import {BASE_PATH} from "@/api/client";
 import {ConnectionBanner} from "@/components/ConnectionBanner";
+import {MobileTopBar} from "@/components/MobileTopBar";
 import {Sidebar} from "@/components/Sidebar";
+import {useIsMobile} from "@/hooks/useMediaQuery";
+import {Drawer} from "@/ui/Drawer";
 import {Overview} from "@/routes/Overview";
 import {Dashboard} from "@/routes/Dashboard";
 import {AgentDetail} from "@/routes/AgentDetail";
@@ -31,18 +35,58 @@ import {useLiveContext} from "@/hooks/useLiveContext";
 
 // ── Root layout ──────────────────────────────────────────────────────────
 
+function routeTitle(pathname: string): string {
+	if (pathname === "/" || pathname === "") return "Overview";
+	if (pathname.startsWith("/dashboard")) return "Dashboard";
+	if (pathname.startsWith("/workbench")) return "Workbench";
+	if (pathname.startsWith("/tasks")) return "Tasks";
+	if (pathname.startsWith("/wiki")) return "Wiki";
+	if (pathname.startsWith("/settings")) return "Settings";
+	if (pathname.startsWith("/projects")) return "Projects";
+	if (pathname.startsWith("/logs")) return "Logs";
+	const agentMatch = pathname.match(/^\/agents\/[^/]+(?:\/([^/]+))?/);
+	if (agentMatch) {
+		const sub = agentMatch[1];
+		if (!sub) return "Agent";
+		return sub.charAt(0).toUpperCase() + sub.slice(1);
+	}
+	return "";
+}
+
 function RootLayout() {
 	const {liveStates, connectionState, hasData} = useLiveContext();
 	const location = useLocation();
-	const bare = location.pathname.startsWith("/workbench") || location.pathname.startsWith("/dashboard");
+	const isMobile = useIsMobile();
+	const [drawerOpen, setDrawerOpen] = useState(false);
+
+	const bare =
+		location.pathname.startsWith("/workbench") ||
+		location.pathname.startsWith("/dashboard");
+
+	// Auto-close drawer on route change.
+	useEffect(() => {
+		setDrawerOpen(false);
+	}, [location.pathname]);
 
 	return (
 		<div className="flex h-screen flex-col overflow-hidden bg-sidebar">
 			<ConnectionBanner state={connectionState} hasData={hasData} />
+			{isMobile && (
+				<MobileTopBar
+					title={routeTitle(location.pathname)}
+					onMenu={() => setDrawerOpen(true)}
+				/>
+			)}
 			<div className="flex min-h-0 flex-1">
-				<Sidebar liveStates={liveStates} />
-				<div className="flex min-w-0 flex-1 flex-col overflow-hidden py-[10px] pr-[10px]">
-					{bare ? (
+				{!isMobile && <Sidebar liveStates={liveStates} />}
+				<div
+					className={
+						isMobile
+							? "flex min-w-0 flex-1 flex-col overflow-hidden"
+							: "flex min-w-0 flex-1 flex-col overflow-hidden py-[10px] pr-[10px]"
+					}
+				>
+					{bare || isMobile ? (
 						<Outlet />
 					) : (
 						<div className="flex min-w-0 flex-1 flex-col overflow-hidden rounded-2xl border border-app-line bg-app">
@@ -51,6 +95,16 @@ function RootLayout() {
 					)}
 				</div>
 			</div>
+			{isMobile && (
+				<Drawer
+					open={drawerOpen}
+					onOpenChange={setDrawerOpen}
+					side="left"
+					ariaLabel="Primary navigation"
+				>
+					<Sidebar liveStates={liveStates} fillWidth />
+				</Drawer>
+			)}
 		</div>
 	);
 }

interface/src/routes/AgentConfig.tsx

@@ -19,6 +19,8 @@ import {
 	type SaveHandlerRef,
 } from "@/components/agent-config";
 import {AgentIngest} from "@/routes/AgentIngest";
+import {useIsMobile} from "@/hooks/useMediaQuery";
+import {CaretLeft} from "@phosphor-icons/react";
 
 interface AgentConfigProps {
 	agentId: string;
@@ -32,26 +34,33 @@ export function AgentConfig({agentId}: AgentConfigProps) {
 	const [dirty, setDirty] = useState(false);
 	const [saving, setSaving] = useState(false);
 	const saveHandlerRef = useRef<SaveHandlerRef>({});
+	const isMobile = useIsMobile();
+	const [mobileShowDetail, setMobileShowDetail] = useState<boolean>(!!search.tab);
 
 	// Sync activeSection with URL search param
 	useEffect(() => {
 		if (search.tab) {
 			const validSections = SECTIONS.map((section) => section.id);
 			if (validSections.includes(search.tab as SectionId)) {
 				setActiveSection(search.tab as SectionId);
+				setMobileShowDetail(true);
 			}
 		}
 	}, [search.tab]);
 
 	const handleSectionChange = (section: SectionId) => {
 		setActiveSection(section);
+		setMobileShowDetail(true);
 		navigate({
 			to: "/agents/$agentId/config",
 			params: {agentId},
 			search: {tab: section},
 		});
 	};
 
+	const showList = !isMobile || !mobileShowDetail;
+	const showDetail = !isMobile || mobileShowDetail;
+
 	const agentsQuery = useQuery({
 		queryKey: ["agents"],
 		queryFn: () => api.agents(),
@@ -187,13 +196,31 @@ export function AgentConfig({agentId}: AgentConfigProps) {
 
 	return (
 		<div className="flex h-full relative">
-			<ConfigSidebar
-				activeSection={activeSection}
-				onSectionChange={handleSectionChange}
-				identityData={identityData}
-			/>
+			{showList && (
+				<ConfigSidebar
+					activeSection={activeSection}
+					onSectionChange={handleSectionChange}
+					identityData={identityData}
+				/>
+			)}
 
+			{showDetail && (
 			<div className="flex flex-1 flex-col overflow-hidden">
+				{isMobile && (
+					<div className="flex shrink-0 items-center gap-2 border-b border-app-line/50 px-2 py-1.5">
+						<button
+							type="button"
+							aria-label="Back to config sections"
+							onClick={() => setMobileShowDetail(false)}
+							className="flex h-11 w-11 items-center justify-center rounded-lg text-ink hover:bg-app-box/60 active:bg-app-box/80"
+						>
+							<CaretLeft size={20} weight="regular" />
+						</button>
+						<span className="truncate text-sm font-medium text-ink">
+							{active.label}
+						</span>
+					</div>
+				)}
 				{isIngestSection ? (
 					<AgentIngest agentId={agentId} />
 				) : isGeneralSection ? (
@@ -238,8 +265,9 @@ export function AgentConfig({agentId}: AgentConfigProps) {
 					/>
 				)}
 			</div>
+			)}
 
-			{!isIngestSection && (
+			{showDetail && !isIngestSection && (
 				<SaveBar
 					dirty={dirty}
 					saving={saving}