Workspace Manager

Window showing a sample multi-repo task workspace with sync, teardown and open-in-IDE buttons that return canned results. Discovery helpers exist in the code but are not wired to the window.

packages/workspace-manager

Workspace Manager is partly a prototype. What you see in the window is sample data; some useful code exists behind it but the window does not call it yet.

What the window shows

The header carries a branch drop-down with three sample branch names and a commit badge. Below it are stat cards and a Multi-Repo Projects list with one sample project, and a panel titled “Task Worktree Environment & Multi-Root IDE Bridge” for a sample task workspace (TASK-102-order-sync, three repositories).

Button	Behavior today
Sync Worktrees	Marks the sample workspace active and reports “3 worktrees created in 180ms”. No git worktree command runs.
Teardown Workspace	Marks the sample workspace cleaned and reports that worktrees were removed. Nothing is removed.
Open in IDE	Reports that a multi-root workspace was opened. It returns a path but does not start an IDE.
Branch drop-down	Changes the commit badge only.

The .robos/projects.yaml file mentioned in the header is not read.

What exists in the main process

main.js and preload.js also expose handlers that the current window does not use:

• scan-workspaces walks ~, ~/source and /usr/local/share/robos (up to six levels deep, skipping node_modules, .git and other dot folders) and lists every folder that contains .vscode or .idea, newest first.
• detect-ides checks for Cursor, VS Code, IntelliJ IDEA, WebStorm, PyCharm, GoLand, CLion and Rider commands on the PATH. open-in-ide, open-terminal (Tilix) and open-in-files start them on a path.
• get-git-info returns the branch, origin URL and dirty state of a folder. Scan roots and depth are stored under workspace_manager in ~/.config/robos/settings.json, and per-workspace state under ~/.config/robos/workspace-states/.
• A Unix socket at /run/user/<uid>/robos-wm.sock answers {"listDesktops": true} with the contents of ~/.config/robos/desktops/*.json.

Related

Workspace Manager MCP Server is the agent-facing counterpart and is also a prototype. To work on a real repository today, use Git Projects or open the folder in your IDE directly.

Run it

Launch RobOS Workspace Manager from the app launcher, or run npm start in packages/workspace-manager.

More in Desktop & Command Center

App Launcher A searchable grid of the desktop applications installed on the machine, including the RobOS apps. Desktop Customizer A slash-command console that changes GNOME settings (clock, taskbar, theme, shortcuts, startup apps) and keeps git-backed snapshots to roll back. Desktop Dashboard A full-screen window that sits at desktop level and shows a grid of widgets; today it contains one clock and date widget. Desktop Manager The background process that launches RobOS apps, restarts the ones marked keep-alive, owns the tray icon and listens on a Unix socket. Desktop Shell Full-screen top bar and bottom dock for RobOS on a GNOME/X11 session, replacing the GNOME panel while it runs. Desktop Widgets A transparent panel on the right edge of the desktop with five status widgets: active task, system stats, AI agent, work journal and security. Dev Central Your daily task list: issues from your task servers as an epic tree, with buttons to start design or implementation agents and to open the related PR. Dev Discussions A chat-style view of discussion threads attached to tasks and pull requests, stored in a local cache with optional posting to GitHub. Icon Manager Shows the icon of every installed RobOS app, lets you replace one, and rewrites the apps' installed icon.svg and .desktop Icon= lines. Manager Dashboard Team metrics for one GitHub repository: open issues, merged PRs, PR cycle time, deploy frequency, approval rate, tasks by stage and PRs per developer. Notifications Center Shows the notification history stored in ~/.config/robos/notifications.json, with filters by category, tier and date, and edits the notification preferences. Package Manager Prototype screen for listing apps and daemons with start, stop and health-probe buttons. It shows built-in sample data. RobOS Audio Player Open-source audio player, custom playlist engine, procedural focus soundscapes, and zero-cloud Google Cast smart speaker streaming. RobOS Dashboards Create KGraph graphical dashboards from card layouts where each widget is any RobOS component, embeddable via and castable to Smart TVs RobOS GNOME Desktop App Installer Install, manage, and repair GNOME Desktop shortcuts, App Grid launchers, multi-scale icons, and Dock favorites for all RobOS apps. RobOS Home Speaker Smart speaker intercom, walkie-talkie voice notes, neural TTS broadcast, custom audio streaming, and soundboard. RobOS Preferences Settings window for RobOS apps: optional AI API mode, agent tiers, prompt security, GitHub accounts, IDE, notifications, journal and theme. RobOS Smart TV Studio Pair Smart TVs, build & sideload Developer Mode TV apps (LG webOS, Samsung Tizen, Google TV/ADB, Roku), serve the 10-foot D-Pad TV Portal (:19210), and stream 4K games. Search Indexer Builds plain-text lists of file paths under folders you choose, which RobOS text areas search for @-mentions. Software Center Install and manage coding-agent CLIs, IDEs, browsers, game tools and utilities on Windows or Linux. System Logs Viewer Viewer for the structured logs that RobOS apps write to ~/.config/robos/logs, with search and level filters. Toast Daemon Shows overlay toast windows for new entries in ~/.config/robos/notifications.json, with tiers, categories, do-not-disturb and anti-spam limits.