Web Interface

Overview

Rimuru's web interface is a beautiful, real-time dashboard for managing your agent ecosystem. Launch it with a single command and get a full graphical interface for your workflows.

Launching the Web Interface

rimuru web

This starts the web server on http://localhost:3456 by default.

Options

rimuru web --port 8080             # Custom port
rimuru web --host 0.0.0.0          # Listen on all interfaces
rimuru web --open                  # Auto-open browser
rimuru web --readonly              # Read-only mode
rimuru web --no-auth               # Disable authentication (dev only)

Dashboard Sections

1. Agent Overview

The main dashboard shows:

  • Active agent count and status
  • Recent workflow executions
  • Token usage and performance metrics
  • System health indicators

2. Workflow Builder

A visual drag-and-drop interface for creating workflows:

  • Add agents to a canvas
  • Connect them with data flows
  • Configure agent parameters
  • Test workflows in real-time
  • Export as YAML

3. Agent Monitor

Real-time agent monitoring:

  • See agent logs streaming in
  • Track agent state transitions
  • View memory usage per agent
  • Inspect agent decisions

4. MCP Server Manager

Graphical management of MCP servers:

  • Add/remove servers
  • View server status and health
  • Inspect available tools and resources
  • View server logs

5. Memory Browser

Explore the memory store:

  • Search semantic memory
  • View episodic memory timeline
  • Export memory snapshots
  • Clear working memory

6. Plugin Marketplace

Browse and install plugins:

  • Search available plugins
  • View plugin details and ratings
  • One-click installation
  • Manage installed plugins

Authentication

By default, the web interface requires authentication:

rimuru web                          # Uses local auth
rimuru web --token my-secret-token  # Token-based auth

API Access

The web interface also exposes a REST API at http://localhost:3456/api/:

curl http://localhost:3456/api/agents
curl http://localhost:3456/api/workflows
curl http://localhost:3456/api/status

Configuration

Web interface settings in rimuru.yaml:

web: port: 3456 host: localhost open: false readonly: false auth: enabled: true token: "$RIMURU_WEB_TOKEN"