Ruang

What Ruang does

Ruang, Indonesian for room or space, displays your agents in a 3D office. Next to it you see the Kanban board, cron jobs, sessions, memory, folders and logs in one place. Everything is read through the hermes CLI, and nothing is ever changed, so it works as a viewer rather than a controller.

The installer downloads its own Node.js if you lack version 20 or newer, puts files under ~/.local/share/ruang and adds a ruang command to ~/.local/bin without sudo. Run ruang and open http://127.0.0.1:3001. A --service flag installs a systemd user service on Linux, and the server listens on 127.0.0.1 only, so a remote server needs an SSH tunnel.

It works on macOS, Linux and Windows through WSL2. OpenCode is optional, and the project was earlier named mission-control and majujaya.

Key features

• 3D virtual office showing which agents are working
• Views of Kanban board, cron jobs, sessions, memory, folders and logs
• Read-only access through the hermes CLI
• One-line installer with its own Node.js
• Optional systemd user service on Linux
• Optional OpenCode crew support

When to use it

• Watching a Hermes Agent crew work from a browser
• Checking Kanban and cron state without opening the terminal
• Monitoring a home server over an SSH tunnel

Who it is for: Hermes Agent users who want a visual, read-only overview of their agents and boards.

How it fits with Hermes Agent

It is built for Hermes Agent and reads all data through the hermes CLI.

How to install Ruang

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -fsSL https://raw.githubusercontent.com/yugienugraha/ruang/main/install.sh | bash
ruang

Requirements: Hermes Agent CLI (hermes) installed; macOS, Linux or Windows through WSL2; opencode optional

FAQ