Agent Profile Daemon

Creates short-lived agent profiles with their own home directory (tmpfs when run as root) and runs commands with that home and environment.

packages/robos-profiled

Agent Profile Daemon provisions “ephemeral agent profiles”: a home directory plus environment variables that a command runs with. The window title is RobOS Ephemeral Profile Manager.

What provisioning does

For a name such as reviewer, the daemon creates a profile my-agent-reviewer and:

  • creates a home directory under ~/.config/robos/profiled/homes/ (or /home when run as root). Only when run as root does it mount a tmpfs there (mount -t tmpfs, default size 2G). As a normal user the directory is an ordinary folder and the profile is flagged as a mock mount;
  • copies files from /etc/skel and writes a baseline .bashrc and .profile;
  • sets up display variables (DISPLAY, WAYLAND_DISPLAY, XAUTHORITY) in the profile, and forwards the SSH agent socket, your git identity and the ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY and GITHUB_TOKEN values from your environment (a placeholder string is used when a key is not set);
  • records a random UID, a scope name, group names (video, render, audio, kvm) and a memory value.

The UID, groups and scope are stored in the profile record only. The code does not run useradd, add the groups, or create a cgroup. Commands run as your own user with HOME and a few ROBOS_* variables changed.

On termination it removes the forwarded links, unmounts (as root) and deletes the home directory. State is in ~/.config/robos/profiled/profiles.json.

Use it

In the window, + Provision Profile asks for a name, a role (Code Reviewer, Implementation Agent, Test Fabric Runner) and a model name, and Spawn 4x Swarm creates swarm-1 to swarm-4. To open the window, run electron . --no-sandbox in packages/robos-profiled; there is no .desktop launcher.

While the app is open it listens on ~/.config/robos/profiled/profiled.sock. Two scripts in the package use that socket and need python3:

robos-profile create reviewer --role "Code Reviewer"
robos-profile list
robos-profile inspect my-agent-reviewer
robos-profile terminate my-agent-reviewer

robos-run-as --agent worker-1 --autoclean npm test

robos-run-as creates the profile if needed, runs the command with the profile’s HOME and environment, and with --autoclean terminates the profile when the command exits.

More in Agent Services & MCP Servers

Agent Autoconfig Writes MCP configuration and instruction files so Claude Code, Gemini, Copilot and Cursor all point at the RobOS MCP router. Agent Daemon (agentd) Keeps a registry of sub-agent sessions, each with its own home directory and environment, behind a Unix socket and a small window. Agent Session Library Node.js client for the agentd socket, plus a small demo window and a simulated test-driven-development runner. CI Monitor MCP Server An MCP server that lets agents list Buildkite builds and read failed-job logs, backed by the connection set up in CI Monitor. Dev Tools MCP Server An MCP server with a small catalog of developer CLI tools; "install" and "check" read and write a JSON file and do not touch the system. Engineering Knowledge Graph MCP Server An MCP server that lets agents search and edit a small node store, query and propose changes to the SDLC graph, and look up schema types. IDE Bridge MCP Server An MCP server that forwards IDE commands (open file, breakpoints, run configurations, refactorings) to the RobOS IntelliJ plugin on port 63343. MCP Router Single MCP endpoint that lists the tools of the servers in the registry and routes tool calls to them, with built-in fallbacks. MCP Server Framework Node.js library for building small Model Context Protocol servers, with an HTTP and a stdio transport and a shared registry file. RobOS CLI Tools Four shell scripts for scripts and agents: send a notification, set the active task, append to the work journal, and emit or read events. System MCP Server MCP server with six tools for preferences, notifications, a tool inventory, file-name search and the active task, backed by a JSON file with sample data. Task Manager MCP Server MCP server with seven tools for listing, creating and advancing tasks stored in ~/.config/robos/tasks/tasks.json. Workspace Manager MCP Server MCP server with six workspace tools, backed by a JSON file of sample workspaces. Several tools return canned results and do not run anything.