What is Runeya?

Runeya is an open-source process, service, and AI workflow management tool designed for developers and teams. It centralizes starting, stopping, monitoring, and configuring all your services from a single interface, and integrates artificial intelligence features directly into your development environment.

Problem Solved

In modern development, a project may require a dozen simultaneously running processes: backend API, queue worker, database, mail server, microservices... Managing them manually across multiple terminals is tedious and error-prone. On top of that, AI tools are often separate from the rest of the development environment.

Runeya replaces this friction with a unified interface featuring:

• A control panel to start/stop/restart each service
• Centralized real-time logs with filters and parsers
• Environment variable management per environment (dev, staging, prod)
• Versioned and shareable configuration
• Built-in multi-model AI chat with encrypted messages
• A graphical AI workflow editor (Scenarios) with conditional branching
• A multi-agent organization simulator (Enterprise)

AI Features

Chat & Multi-model AI

Runeya integrates an AI chat directly into the interface. You can start conversations with different models (Claude, Codex, and other configured providers). Conversations are encrypted at rest with AES-256-GCM and remain stored locally.

You can also use Claude Code CLI from Runeya: the chat automatically detects if Claude Code is available on your machine and offers this mode as an alternative to the API-based chat.

Learn more: Chat & AI

Scenarios

Scenarios let you create graphical AI workflows: a sequence of nodes (steps) connected together that Runeya executes automatically. Each node can be a prompt sent to the AI, or a step that waits for user input. You can define conditional branches so the AI chooses the next path based on each step's result.

Example use case: describe a bug → the AI analyzes the logs → if the bug is critical, it creates a ticket; otherwise, it suggests a fix.

Learn more: Scenarios

Enterprise

Enterprise lets you simulate an organization (teams, people, hierarchy) and run an AI conversation where each "person" responds according to their defined role. This is useful for simulating multi-team code reviews, planning meetings, or any process involving multiple stakeholders.

Learn more: Enterprise

Architecture

┌─────────────┐     tRPC/HTTP     ┌─────────────┐
│   Web UI    │ ◄───────────────► │   Server    │
│  (Vue 3)    │                   │  (Express)  │
└─────────────┘                   └──────┬──────┘
                                         │ HTTP Bearer
                                         ▼
                                  ┌─────────────┐
                                  │    Agent    │
                                  │  (Express)  │
                                  └──────┬──────┘
                                         │ execa
                                         ▼
                                  ┌─────────────┐
                                  │  Processes  │
                                  │ (your apps) │
                                  └─────────────┘

Three main components:

Component	Role
Web UI	Vue 3 interface, real-time monitoring, configuration, AI chat, Scenario editor
Server	Orchestration, JSON persistence, AI routers (chat, scenario, enterprise)
Agent	Process execution, stateless, remotely deployable

Operating Modes

Local-simple mode (current)

• No authentication required
• Accessible only from localhost
• Perfect for solo development

Philosophy

• Local-first: everything works offline
• Fully open-source: local server + UI all under MIT
• Security by default: encrypted secrets, localhost bindings, Bearer auth
• Minimal: no system daemon, no root agent, simple JSON configuration