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
docs(comparison): refresh product audit
Rahman1590e7a4bc13
diff --git a/README.md b/README.mdindex 7e6eb776..0994b493 100644--- a/README.md+++ b/README.md@@ -112,7 +112,7 @@ Successful analysis jobs are not proof of zero open alerts; the security badge a[Security policy](./SECURITY.md) · [Verification and known limits](./docs/SECURITY-ASSURANCE.md)<!-- comparison:start -->-[Product comparison, evidence and limitations](docs/COMPARISON.md) · reviewed 2026-08-29.+[Product comparison, evidence and limitations](docs/COMPARISON.md) · reviewed 2026-09-17.<!-- comparison:end -->[MIT license](./LICENSE) · [Detailed workspace guide](./docs/reference/WORKSPACE-GUIDE.md)diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex f5a4d894..e4edfd9e 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -11,6 +11,10 @@ this is the *what*, and it is what Settings → About shows as “What's new”.- `installer` build node-pty reliably on Codespaces- `managed-apps` support Hermes without systemd+**Docs**++- `comparison` refresh product audit+## 2026-09-16**Added**diff --git a/docs/COMPARISON.md b/docs/COMPARISON.mdindex cedf34c7..91f43557 100644--- a/docs/COMPARISON.md+++ b/docs/COMPARISON.md@@ -1,7 +1,7 @@<!-- Generated by scripts/gen-comparison.mjs from docs/comparison-data.json. Do not edit by hand. --># Product comparison-Last reviewed: **2026-08-29** · freshness gate: **90 days**+Last reviewed: **2026-09-17** · freshness gate: **90 days**MSO is designed as a mobile-first, AI-native private Linux workspace for an owner or small trusted team. It does not claim to replace specialist products at their strongest specialty.@@ -45,11 +45,11 @@ Built-in AI assistance plus structured remote tool/API control of the workspace.|---|---|:---:|:---:|:---:|:---:|:---:|:---:|| **MSO** | Mobile-first private Linux workspace | Strong | Partial | Partial | Partial | Partial | Strong || **Cockpit** | Deep graphical Linux administration | Partial | Strong | Partial | Partial | Strong | Not offered |-| **Coolify** | Self-hosted Git/PaaS delivery | Partial | Partial | Strong | Partial | Strong | Not offered |+| **Coolify** | Self-hosted Git/PaaS delivery | Partial | Partial | Strong | Partial | Strong | Partial || **Portainer** | Container and stack operations | Partial | Partial | Strong | Partial | Partial | Not offered |-| **Netdata** | High-resolution observability and RCA | Partial | Not offered | Not offered | Strong | Partial | Partial |+| **Netdata** | High-resolution observability and RCA | Partial | Not offered | Not offered | Strong | Partial | Strong || **Tailscale SSH** | Identity-aware private remote access | Not offered | Partial | Not offered | Not offered | Strong | Not offered |-| **File Browser** | Focused web file management | Partial | Not offered | Not offered | Not offered | Partial | Not offered |+| **File Browser** | Archived focused web file management | Partial | Not offered | Not offered | Not offered | Partial | Not offered || **ttyd** | Small, focused web terminal | Partial | Not offered | Not offered | Not offered | Partial | Not offered || **CasaOS** | Friendly personal-cloud home server | Partial | Partial | Partial | Partial | Not offered | Not offered || **Runtipi** | Curated one-click self-hosted apps | Partial | Not offered | Strong | Partial | Not offered | Not offered |@@ -60,12 +60,12 @@ Built-in AI assistance plus structured remote tool/API control of the workspace.**Best fit:** Mobile-first private Linux workspace-- **Browser workspace (Strong):** Files, real PTY, code/media editors, managed apps, responsive shells, PWA, and CLI share one API surface. Evidence: `app/os-root.tsx`, `frontend/slices/files-manager/app.tsx`, `frontend/slices/os-terminal/components/pty-terminal.tsx`, `frontend/slices/appshell/responsive/responsive-provider.tsx`.+- **Browser workspace (Strong):** Files, real PTY, code/media editors, managed apps, Integrations, Workflows, Organization, responsive shells, PWA, and CLI share one authenticated runtime. Evidence: `app/os-root.tsx`, `frontend/slices/files-manager/app.tsx`, `frontend/slices/os-terminal/components/pty-terminal.tsx`, `frontend/slices/workflows/app.tsx`, `frontend/slices/organization/app.tsx`, `frontend/slices/appshell/responsive/responsive-provider.tsx`.- **Linux host administration (Partial):** Live metrics/processes, service inventory and logs, exact allowlisted systemd lifecycle, package-cache visibility, full owner shell. No first-class network/storage/user administration yet. Evidence: `lib/host/sys.ts`, `lib/host/services.ts`, `lib/host/package-updates.ts`, `frontend/slices/system-monitor/app.tsx`.-- **Application delivery (Partial):** Pinned managed-app install/update/backup/rollback paths exist, but MSO is not yet a general Git-to-container PaaS. Evidence: `lib/managed-apps/install.ts`, `lib/managed-apps/update.ts`, `lib/managed-apps/backups.ts`.+- **Application delivery (Partial):** Pinned managed-app install/update/backup/rollback paths are built in, and named Integrations can orchestrate GitHub/Dokploy delivery plus DNS/provider operations. MSO still delegates the underlying PaaS/container control plane rather than replacing one. Evidence: `lib/managed-apps/install.ts`, `lib/managed-apps/update.ts`, `lib/managed-apps/backups.ts`, `lib/infra/dokploy.ts`, `lib/infra/connection-dispatch.ts`.- **Monitoring and observability (Partial):** Live host metrics and processes are built in; long-term history, alert rules, anomaly correlation, and RCA remain specialist gaps. Evidence: `frontend/slices/system-monitor/app.tsx`, `frontend/slices/system-monitor/lib/use-stats-history.ts`, `lib/host/sys.ts`.- **Roles and delegation (Partial):** Approved devices have live Viewer, Operator, and Owner roles with audit and immediate revocation. This is not a full user directory, Linux-account mapping, or SSO system. Evidence: `lib/auth/roles.ts`, `lib/auth/device-store.ts`, `app/api/auth/devices/route.ts`, `app/os-root.tsx`.-- **Built-in AI and MCP (Strong):** BYOK Alfa, structured host/editor tools, remote OAuth/PKCE MCP, CLI parity, and project-aware tool discovery are native product surfaces. Evidence: `app/api/assistant/route.ts`, `app/mcp/route.ts`, `lib/mcp/dispatch.ts`, `frontend/slices/assistant/app.tsx`.+- **Built-in AI and MCP (Strong):** BYOK plus dynamic provider discovery, structured host/editor/integration/workflow tools, OAuth/PKCE Streamable-HTTP MCP, ChatGPT list/page surfaces, durable agent sessions, and project-aware MCP discovery are native product surfaces. Evidence: `app/api/assistant/route.ts`, `app/mcp/route.ts`, `lib/mcp/tools.ts`, `app/api/v1/agent-sessions/route.ts`, `frontend/slices/workflows/app.tsx`.Official sources:- [MSO repository](https://github.com/rahmanef63/mso)@@ -93,11 +93,12 @@ Official sources:- **Application delivery (Strong):** Git integrations, automatic and preview deployments, one-click services, SSL, databases, backups, webhooks, and API.- **Monitoring and observability (Partial):** Deployment/server/container monitoring and notifications, but not deep per-second anomaly/RCA analytics.- **Roles and delegation (Strong):** Team projects, roles, and permissions are first-class product features.-- **Built-in AI and MCP (Not offered):** No native AI workspace or MCP host control comparable to MSO.+- **Built-in AI and MCP (Partial):** Coolify now exposes a native team-scoped MCP server with tools, resources, prompts, deployment/lifecycle operations, logs, and Git integration discovery. Its documented MCP flow is client-driven through compatible external AI clients rather than an integrated Coolify assistant surface.Official sources:- [Coolify features](https://coolify.io/docs)- [Coolify CI/CD](https://coolify.io/docs/applications/ci-cd)+- [Coolify MCP](https://coolify.io/docs/mcp/what-is-mcp)### Portainer@@ -112,7 +113,7 @@ Official sources:Official sources:- [Portainer documentation](https://docs.portainer.io/)-- [Portainer stack operations](https://docs.portainer.io/2.33-lts/user/docker/stacks/edit)+- [Portainer stack delivery](https://docs.portainer.io/user/docker/stacks/add)### Netdata@@ -122,12 +123,15 @@ Official sources:- **Linux host administration (Not offered):** Observes hosts and services; it is not a general administration shell.- **Application delivery (Not offered):** Does not provide general application deployment workflows.- **Monitoring and observability (Strong):** Per-second metrics, alerts, anomaly scores, correlation, cross-node analysis, and AI-generated incident insights.-- **Roles and delegation (Partial):** Cloud/team access exists, but identity and remote host access are not its primary comparison axis.-- **Built-in AI and MCP (Partial):** AI Insights explains telemetry and recommends actions; it does not expose a general host-action MCP surface.+- **Roles and delegation (Partial):** Team management exists, and paid plans add RBAC and SSO; identity and remote host access are not Netdata’s primary product scope.+- **Built-in AI and MCP (Strong):** Netdata AI provides built-in conversations, insights and investigations, while native Cloud and Agent/Parent MCP servers expose metrics, alerts, logs, anomaly/RCA queries, and supported function execution to AI clients.Official sources:- [Netdata charts](https://learn.netdata.cloud/docs/dashboards-and-charts/charts)- [Netdata AI Insights](https://learn.netdata.cloud/docs/netdata-ai/insights)+- [Netdata AI](https://learn.netdata.cloud/docs/netdata-ai)+- [Netdata MCP](https://learn.netdata.cloud/docs/netdata-ai/mcp)+- [Netdata access control](https://learn.netdata.cloud/docs/security-and-privacy-design/access-control-and-feature-availability)### Tailscale SSH@@ -145,9 +149,9 @@ Official sources:### File Browser-**Best fit:** Focused web file management+**Best fit:** Archived focused web file management-- **Browser workspace (Partial):** Strong upload/delete/preview/edit file surface, without a complete server workspace.+- **Browser workspace (Partial):** The final shipped product provides upload/delete/preview/edit file management, but the repository is now archived and no longer maintained.- **Linux host administration (Not offered):** No general service, package, network, or storage administration.- **Application delivery (Not offered):** No application deployment control plane.- **Monitoring and observability (Not offered):** No host metrics/alerting system.diff --git a/docs/comparison-data.json b/docs/comparison-data.jsonindex a5c978c7..ef92ac3b 100644--- a/docs/comparison-data.json+++ b/docs/comparison-data.json@@ -1,6 +1,6 @@{"schemaVersion": 1,- "reviewedAt": "2026-08-29",+ "reviewedAt": "2026-09-17","expiresAfterDays": 90,"positioning": "MSO is designed as a mobile-first, AI-native private Linux workspace for an owner or small trusted team. It does not claim to replace specialist products at their strongest specialty.","legend": {@@ -54,11 +54,13 @@"ratings": {"workspace": {"value": "strong",- "note": "Files, real PTY, code/media editors, managed apps, responsive shells, PWA, and CLI share one API surface.",+ "note": "Files, real PTY, code/media editors, managed apps, Integrations, Workflows, Organization, responsive shells, PWA, and CLI share one authenticated runtime.","evidence": ["app/os-root.tsx","frontend/slices/files-manager/app.tsx","frontend/slices/os-terminal/components/pty-terminal.tsx",+ "frontend/slices/workflows/app.tsx",+ "frontend/slices/organization/app.tsx","frontend/slices/appshell/responsive/responsive-provider.tsx"]},@@ -74,11 +76,13 @@},"delivery": {"value": "partial",- "note": "Pinned managed-app install/update/backup/rollback paths exist, but MSO is not yet a general Git-to-container PaaS.",+ "note": "Pinned managed-app install/update/backup/rollback paths are built in, and named Integrations can orchestrate GitHub/Dokploy delivery plus DNS/provider operations. MSO still delegates the underlying PaaS/container control plane rather than replacing one.","evidence": ["lib/managed-apps/install.ts","lib/managed-apps/update.ts",- "lib/managed-apps/backups.ts"+ "lib/managed-apps/backups.ts",+ "lib/infra/dokploy.ts",+ "lib/infra/connection-dispatch.ts"]},"observability": {@@ -102,12 +106,13 @@},"aiControl": {"value": "strong",- "note": "BYOK Alfa, structured host/editor tools, remote OAuth/PKCE MCP, CLI parity, and project-aware tool discovery are native product surfaces.",+ "note": "BYOK plus dynamic provider discovery, structured host/editor/integration/workflow tools, OAuth/PKCE Streamable-HTTP MCP, ChatGPT list/page surfaces, durable agent sessions, and project-aware MCP discovery are native product surfaces.","evidence": ["app/api/assistant/route.ts","app/mcp/route.ts",- "lib/mcp/dispatch.ts",- "frontend/slices/assistant/app.tsx"+ "lib/mcp/tools.ts",+ "app/api/v1/agent-sessions/route.ts",+ "frontend/slices/workflows/app.tsx"]}}@@ -161,6 +166,10 @@{"label": "Coolify CI/CD","url": "https://coolify.io/docs/applications/ci-cd"+ },+ {+ "label": "Coolify MCP",+ "url": "https://coolify.io/docs/mcp/what-is-mcp"}],"ratings": {@@ -185,8 +194,8 @@"note": "Team projects, roles, and permissions are first-class product features."},"aiControl": {- "value": "none",- "note": "No native AI workspace or MCP host control comparable to MSO."+ "value": "partial",+ "note": "Coolify now exposes a native team-scoped MCP server with tools, resources, prompts, deployment/lifecycle operations, logs, and Git integration discovery. Its documented MCP flow is client-driven through compatible external AI clients rather than an integrated Coolify assistant surface."}}},@@ -200,8 +209,8 @@"url": "https://docs.portainer.io/"},{- "label": "Portainer stack operations",- "url": "https://docs.portainer.io/2.33-lts/user/docker/stacks/edit"+ "label": "Portainer stack delivery",+ "url": "https://docs.portainer.io/user/docker/stacks/add"}],"ratings": {@@ -243,6 +252,18 @@{"label": "Netdata AI Insights","url": "https://learn.netdata.cloud/docs/netdata-ai/insights"+ },+ {+ "label": "Netdata AI",+ "url": "https://learn.netdata.cloud/docs/netdata-ai"+ },+ {+ "label": "Netdata MCP",+ "url": "https://learn.netdata.cloud/docs/netdata-ai/mcp"+ },+ {+ "label": "Netdata access control",+ "url": "https://learn.netdata.cloud/docs/security-and-privacy-design/access-control-and-feature-availability"}],"ratings": {@@ -264,11 +285,11 @@},"delegation": {"value": "partial",- "note": "Cloud/team access exists, but identity and remote host access are not its primary comparison axis."+ "note": "Team management exists, and paid plans add RBAC and SSO; identity and remote host access are not Netdata’s primary product scope."},"aiControl": {- "value": "partial",- "note": "AI Insights explains telemetry and recommends actions; it does not expose a general host-action MCP surface."+ "value": "strong",+ "note": "Netdata AI provides built-in conversations, insights and investigations, while native Cloud and Agent/Parent MCP servers expose metrics, alerts, logs, anomaly/RCA queries, and supported function execution to AI clients."}}},@@ -312,7 +333,7 @@{"id": "file-browser","name": "File Browser",- "bestFor": "Focused web file management",+ "bestFor": "Archived focused web file management","sources": [{"label": "File Browser repository",@@ -322,7 +343,7 @@"ratings": {"workspace": {"value": "partial",- "note": "Strong upload/delete/preview/edit file surface, without a complete server workspace."+ "note": "The final shipped product provides upload/delete/preview/edit file management, but the repository is now archived and no longer maintained."},"hostOps": {"value": "none",