Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
feat(organization): surface as first-class app
Rahmand393347d60a8
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex b578a72d..f0c17494 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -8,6 +8,7 @@ this is the *what*, and it is what Settings → About shows as “What's new”.**Added**+- `organization` surface as first-class app- `organization` add agent org chart and routing- `workflows` complete server-native automation parity- `workflows` add server-native workflow graphdiff --git a/docs/ORGANIZATION.md b/docs/ORGANIZATION.mdindex 0240a279..619cb08b 100644--- a/docs/ORGANIZATION.md+++ b/docs/ORGANIZATION.md@@ -100,7 +100,7 @@ This is a private runtime store. MSO source ships **no operator-specific organiz## UI-Open **Alfa → Organization**.+Open the first-class **Organization** app from the dock, launcher, Start menu, App Library, Spotlight, or `/organization`. **Alfa → Organization** remains a secondary deep-link to the same view and SSOT.The default `All organization` view renders the complete reporting hierarchy across units. Selecting a unit filters the view while keeping the same SSOT. Seat cards show role, unit, seat mode, execution binding, and current runtime state.diff --git a/docs/SLICE-CATALOG.md b/docs/SLICE-CATALOG.mdindex 10d5a193..45285250 100644--- a/docs/SLICE-CATALOG.md+++ b/docs/SLICE-CATALOG.md@@ -3,12 +3,12 @@> **Current reference.** Counts are checked against the directory tree by> `scripts/check-docs.mjs`; the directory remains the final authority.-<!-- slice-catalog: slices=24 appshell-features=10 -->+<!-- slice-catalog: slices=25 appshell-features=10 -->Every application is a vertical slice under `frontend/slices/`. Host-facing slices use theshared API/host seam rather than reaching arbitrary Node host APIs from client code.-## Slices (24)+## Slices (25)| Slug | Purpose ||---|---|@@ -31,6 +31,7 @@ shared API/host seam rather than reaching arbitrary Node host APIs from client c| `os-settings` | MSO Settings || `os-shell` | MSO consumer manifest/capabilities for AppShell || `os-terminal` | Interactive PTY Terminal / Claude Code surface |+| `organization` | Owner-private organization chart, reporting lines, seat state, and execution bindings || `quicklinks` | Website shortcuts/favicons || `reel-editor` | Video/reel timeline editor || `shell-settings` | Shared shell settings UI primitives |diff --git a/frontend/slices/appshell/components/mobile-app-library.tsx b/frontend/slices/appshell/components/mobile-app-library.tsxindex c6613909..9debec69 100644--- a/frontend/slices/appshell/components/mobile-app-library.tsx+++ b/frontend/slices/appshell/components/mobile-app-library.tsx@@ -21,9 +21,12 @@ const CATEGORY: Record<string, string> = {"create-app": "Develop",browser: "Web & AI",assistant: "Web & AI",+ organization: "Work & Automation",+ workflows: "Work & Automation",+ integrations: "Work & Automation","app-store": "Web & AI",};-const ORDER = ["Files & System", "Creative", "Develop", "Web & AI", "Other"];+const ORDER = ["Files & System", "Creative", "Develop", "Work & Automation", "Web & AI", "Other"];// iPhone App Library: category folder-cards by default; an A–Z list while the// search field has text. Tapping a folder's cluster (or its label) opens it.diff --git a/frontend/slices/assistant/CONTRACT.md b/frontend/slices/assistant/CONTRACT.mdindex d9b256eb..7c94de52 100644--- a/frontend/slices/assistant/CONTRACT.md+++ b/frontend/slices/assistant/CONTRACT.md@@ -98,7 +98,7 @@ complete. See [`docs/MCP.md`](../../../docs/MCP.md) and [`skills/README.md`](../## Organization (not an Alfa persona)-The **Organization** tab is a server-side owner-private operating-structure view, not another browser Agent persona store. Its SSOT is `~/.mso/private/organization.json` via `lib/agent/organization-store.ts`. Units and seats define stable hierarchy/reporting context; a seat can point at an existing Project Agent, Local Agent/session, or A2A peer. Those references grant no extra tools or credentials. Workflows may resolve `orgSeatId` at execution time. See [`docs/ORGANIZATION.md`](../../../docs/ORGANIZATION.md).+Organization is a first-class app/domain with a secondary **Organization** tab inside Alfa. Both render the same server-side owner-private SSOT at `~/.mso/private/organization.json` via `lib/agent/organization-store.ts`; Alfa does not own or duplicate it. Units and seats define stable hierarchy/reporting context; a seat can point at an existing Project Agent, Local Agent/session, or A2A peer. Those references grant no extra tools or credentials. Workflows may resolve `orgSeatId` at execution time. See [`docs/ORGANIZATION.md`](../../../docs/ORGANIZATION.md).## Agentdiff --git a/frontend/slices/assistant/app.tsx b/frontend/slices/assistant/app.tsxindex ac778e29..06769275 100644--- a/frontend/slices/assistant/app.tsx+++ b/frontend/slices/assistant/app.tsx@@ -17,7 +17,7 @@ import { ThreadList } from "./components/thread-list";import { LibraryGrid } from "./components/library-grid";import { SkillForm } from "./components/skill-form";import { McpActivityView } from "./components/mcp-activity-view";-import { OrganizationView } from "./components/organization-view";+import { OrganizationView } from "@/features/organization";import { AlfaCockpitBar } from "./components/alfa-cockpit-bar";import { assistantRouteFromPayload, type AssistantTab } from "./lib/navigation";diff --git a/frontend/slices/organization/app.tsx b/frontend/slices/organization/app.tsxnew file mode 100644index 00000000..aa3e8347--- /dev/null+++ b/frontend/slices/organization/app.tsx@@ -0,0 +1,13 @@+"use client";++import type { AppProps } from "@/features/appshell";+import { AppFrame } from "@/features/appshell";+import { OrganizationView } from "./components/organization-view";++export default function OrganizationApp(_props: AppProps) {+ return (+ <AppFrame safeArea={false} className="h-full bg-background" bodyClassName="overflow-hidden">+ <OrganizationView />+ </AppFrame>+ );+}diff --git a/frontend/slices/assistant/components/organization-editor.tsx b/frontend/slices/organization/components/organization-editor.tsxsimilarity index 100%rename from frontend/slices/assistant/components/organization-editor.tsxrename to frontend/slices/organization/components/organization-editor.tsxdiff --git a/frontend/slices/assistant/components/organization-tree.tsx b/frontend/slices/organization/components/organization-tree.tsxsimilarity index 100%rename from frontend/slices/assistant/components/organization-tree.tsxrename to frontend/slices/organization/components/organization-tree.tsxdiff --git a/frontend/slices/assistant/components/organization-view.tsx b/frontend/slices/organization/components/organization-view.tsxsimilarity index 100%rename from frontend/slices/assistant/components/organization-view.tsxrename to frontend/slices/organization/components/organization-view.tsxdiff --git a/frontend/slices/organization/index.ts b/frontend/slices/organization/index.tsnew file mode 100644index 00000000..49ea0ea8--- /dev/null+++ b/frontend/slices/organization/index.ts@@ -0,0 +1,13 @@+import { Network } from "lucide-react";+import type { AppDescriptor } from "@/features/appshell";++export const organizationApp: AppDescriptor = {+ id: "organization",+ title: "Organization",+ icon: Network,+ gradient: "linear-gradient(160deg,#2563eb,#0f172a)",+ load: () => import("./app"),+ defaultSize: { w: 1120, h: 720 },+};++export { OrganizationView } from "./components/organization-view";diff --git a/frontend/slices/assistant/lib/organization-api.ts b/frontend/slices/organization/lib/organization-api.tssimilarity index 100%rename from frontend/slices/assistant/lib/organization-api.tsrename to frontend/slices/organization/lib/organization-api.tsdiff --git a/frontend/slices/os-shell/organization-app.test.ts b/frontend/slices/os-shell/organization-app.test.tsnew file mode 100644index 00000000..b0d10bfb--- /dev/null+++ b/frontend/slices/os-shell/organization-app.test.ts@@ -0,0 +1,12 @@+import { describe, expect, it } from "vitest";+import { BUILTIN_APPS } from "./shell.manifest";++describe("Organization app registration", () => {+ it("exposes Organization as a first-class built-in route", () => {+ const app = BUILTIN_APPS.find((item) => item.id === "organization");+ expect(app).toBeDefined();+ expect(app?.title).toBe("Organization");+ expect(app?.slug).toBe("organization");+ expect(app?.noDock).not.toBe(true);+ });+});diff --git a/frontend/slices/os-shell/shell.manifest.ts b/frontend/slices/os-shell/shell.manifest.tsindex f416454f..c485bee6 100644--- a/frontend/slices/os-shell/shell.manifest.ts+++ b/frontend/slices/os-shell/shell.manifest.ts@@ -22,6 +22,7 @@ import { quicklinksApp } from "@/features/quicklinks";import { docsApp } from "@/features/docs";import { integrationsApp } from "@/features/integrations";import { workflowsApp } from "@/features/workflows";+import { organizationApp } from "@/features/organization";import { cloudflareApp, dokployApp } from "@/features/infrastructure";import { themeQuickPickerFeature } from "./theme-quick-picker";import { serverConnectionStatusFeature } from "./server-connection-status";@@ -69,6 +70,7 @@ export const BUILTIN_APPS: AppDescriptor[] = [withSlug(withArtwork(nineRouterApp), "9router"),pin(withSlug(integrationsApp, "connections")),pin(withSlug(withArtwork(workflowsApp), "workflows")),+ withSlug(withArtwork(organizationApp), "organization"),withSlug(withArtwork(dokployApp), "dokploy"),withSlug(withArtwork(cloudflareApp), "cloudflare"),withSlug(withArtwork(quicklinksApp), "links"),