Wiki

Searchable user manual for runtime behavior, operational flows, API surfaces, and CLI commands.

WebUI Screenshots

4 views

Dashboard Overview screenshot — Overview
Top-level runtime health, activity, and system status.

Dashboard Sessions screenshot — Sessions
Conversation/session management and turn history exploration.

Dashboard Skills screenshot — Skills
Skill inventory, catalog actions, activation, and state controls.

Dashboard Settings screenshot — Settings
Configuration panes for runtime behavior and integrations.

148 entries

Runtime

Runtime startup lifecycle

At startup Roboticus loads config, initializes storage, discovers skills/plugins, wires API surfaces, and then begins agent + scheduler loops.

Use `roboticus serve` to start the runtime. Health and readiness can be checked via `/api/health`, `roboticus status`, and dashboard runtime cards.

startupservehealthruntimereadiness

References: /install, /docs/features, /docs/architecture

Configuration

Configuration apply model

Config mutations are read and applied through runtime APIs with explicit capabilities and apply-status endpoints.

Primary endpoints: `GET/PUT /api/config`, `GET /api/config/capabilities`, and `GET /api/config/status`. CLI mirrors this with `roboticus config show|get|set|unset`.

configsettingsapplystatuscapabilities

References: /docs/api, /docs/cli

Memory

Memory tiers and retrieval

Working memory tracks immediate context, episodic memory tracks event history, and semantic memory stores durable facts with category search.

Inspect memory through `/api/memory/*` endpoints and `roboticus memory list|search` commands. Full-text search is exposed via `/api/memory/search`.

memoryworkingepisodicsemanticsearch

References: /docs/features, /docs/api, /docs/cli

Inference

Model routing and selection telemetry

Requests are routed across available providers/models with observable selection events and efficiency metrics.

See `/api/models/available`, `/api/models/selections`, `/api/stats/efficiency`, and turn-level model inspection endpoints under context observability.

routingmodelsselectiontelemetryefficiency

References: /docs/features, /docs/api

Security

Approvals, policy gates, and audit trails

Potentially risky actions can be gated behind approvals, and policy/tool decisions are exposed through dedicated audit endpoints.

Approval lifecycle: `/api/approvals`, `/approve`, `/deny`. Audit inspection: `/api/audit/policy/:turn_id` and `/api/audit/tools/:turn_id`.

securityapprovalsauditpolicygates

References: /docs/security, /docs/api

Skills

Skill lifecycle: registry -> install -> activate

Skills can come from built-ins or registry catalogs, then be installed, activated, reloaded, and audited.

Skill APIs include `/api/skills`, `/api/skills/catalog`, `/install`, `/activate`, `/reload`, and `/audit`. CLI provides parallel `roboticus skills ...` flows.

skillscataloginstallactivatereload

References: /registry, /docs/api, /docs/cli

Plugins

Plugin lifecycle and execution model

Plugins expose tools through manifests and can be listed, toggled, and invoked through plugin endpoints.

pluginstoolingcatalogtoggleexecute

References: /registry, /docs/api, /docs/cli

Automation

Scheduler and recurring jobs

Cron-like jobs can be created, listed, inspected, and removed, with run history captured for observability.

Use `/api/cron/jobs` and `/api/cron/runs` endpoints or `roboticus schedule` CLI surfaces.

schedulercronjobsautomationruns

References: /docs/api, /docs/cli

Channels

Channel delivery and dead-letter replay

Messaging channels expose status and failed-delivery queues, including replay support for dead letters.

Use `/api/channels/status`, `/api/channels/dead-letter`, and `/api/channels/dead-letter/:id/replay` for monitoring and repair.

channelsdead-letterreplaydeliverymessaging

References: /docs/features, /docs/api

Operations

Release sync and hosted registry behavior

Site release sync mirrors registry packs from roboticus releases and validates checksums for skills and plugin artifacts before deploy.

Registry content is hosted in `public/registry/*` and validated by integrity checks. Plugin catalog entries require archive presence and SHA-256 match.

release-syncregistrychecksumspluginsartifacts

References: /registry, /changelog

Dashboard

Dashboard and live observability surfaces

The dashboard aggregates runtime health, sessions, costs, model routing, channels, skills, and operational controls.

For live stream integrations use WebSocket (`/ws`) and streaming endpoints where applicable.

dashboardobservabilitywscontrol-planeoperations

References: /docs/features, /docs/api

WebUI

WebUI tour and navigation model

The dashboard organizes operations into page-like panes (Overview, Sessions, Memory, Skills, Agents, Scheduler, Metrics, Wallet, Workspace, Settings) with live state indicators.

Navigation is hash-driven (`#overview`, `#sessions`, `#skills`, `#settings`) and updates in place without leaving the dashboard. Use the header Help button to open the wiki manual.

webuidashboardnavigationoverviewsettings

References: /wiki

API

GET /api/health

Quick health check (status, uptime, version)

Route group: Health. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttphealthgetapihealth

References: /docs/api

API

GET /api/config

Current configuration

Route group: Config. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpconfiggetapiconfig

References: /docs/api

API

PUT /api/config

Update configuration

Route group: Config. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpconfigputapiconfig

References: /docs/api

API

GET /api/config/capabilities

Feature capability flags

Route group: Config. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpconfiggetapiconfigcapabilities

References: /docs/api

API

GET /api/config/status

Config apply status

Route group: Config. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpconfiggetapiconfigstatus

References: /docs/api

API

GET /api/logs

Structured log output

Route group: Logs. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttplogsgetapilogs

References: /docs/api

API

GET /api/sessions

List sessions

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionsgetapisessions

References: /docs/api

API

POST /api/sessions

Create new session

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionspostapisessions

References: /docs/api

API

GET /api/sessions/:id

Session detail

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionsgetapisessionsid

References: /docs/api

API

GET /api/sessions/:id/messages

Session message history

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionsgetapisessionsidmessages

References: /docs/api

API

POST /api/sessions/:id/messages

Append message to session

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionspostapisessionsidmessages

References: /docs/api

API

POST /api/sessions/backfill-nicknames

Backfill session nicknames via LLM

Route group: Sessions. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsessionspostapisessionsbackfill-nicknames

References: /docs/api

API

GET /api/memory/working

All working memory entries

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemoryworking

References: /docs/api

API

GET /api/memory/working/:session_id

Working memory (session-scoped)

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemoryworkingsession_id

References: /docs/api

API

GET /api/memory/episodic

Episodic memory (events)

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemoryepisodic

References: /docs/api

API

GET /api/memory/semantic

All semantic memory entries

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemorysemantic

References: /docs/api

API

GET /api/memory/semantic/categories

List semantic memory categories

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemorysemanticcategories

References: /docs/api

API

GET /api/memory/semantic/:category

Semantic memory (facts by category)

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemorysemanticcategory

References: /docs/api

API

GET /api/memory/search

Full-text memory search (FTS5)

Route group: Memory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmemorygetapimemorysearch

References: /docs/api

API

GET /api/models/available

List available LLM models

Route group: Models. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmodelsgetapimodelsavailable

References: /docs/api

API

GET /api/models/selections

Model selection event log

Route group: Models. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpmodelsgetapimodelsselections

References: /docs/api

API

PUT /api/providers/:name/key

Set provider API key

Route group: Providers. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpprovidersputapiprovidersnamekey

References: /docs/api

API

DELETE /api/providers/:name/key

Remove provider API key

Route group: Providers. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpprovidersdeleteapiprovidersnamekey

References: /docs/api

API

GET /api/cron/jobs

List cron jobs

Route group: Scheduler. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpschedulergetapicronjobs

References: /docs/api

API

POST /api/cron/jobs

Create cron job

Route group: Scheduler. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpschedulerpostapicronjobs

References: /docs/api

API

GET /api/cron/jobs/:id

Cron job detail

Route group: Scheduler. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpschedulergetapicronjobsid

References: /docs/api

API

DELETE /api/cron/jobs/:id

Delete cron job

Route group: Scheduler. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpschedulerdeleteapicronjobsid

References: /docs/api

API

GET /api/cron/runs

List recent cron runs

Route group: Scheduler. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpschedulergetapicronruns

References: /docs/api

API

GET /api/stats/costs

Inference cost history

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatscosts

References: /docs/api

API

GET /api/stats/transactions

Financial transaction history

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatstransactions

References: /docs/api

API

GET /api/stats/cache

Cache hit/miss statistics

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatscache

References: /docs/api

API

GET /api/stats/efficiency

Per-model efficiency metrics (period, model filter)

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatsefficiency

References: /docs/api

API

GET /api/stats/timeseries

Overview timeseries data (costs, tokens, requests)

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatstimeseries

References: /docs/api

API

GET /api/stats/capacity

Capacity and usage statistics

Route group: Statistics. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpstatisticsgetapistatscapacity

References: /docs/api

API

GET /api/breaker/status

All provider breaker states

Route group: Circuit Breaker. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcircuit breakergetapibreakerstatus

References: /docs/api

API

POST /api/breaker/reset/:provider

Reset a provider breaker

Route group: Circuit Breaker. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcircuit breakerpostapibreakerresetprovider

References: /docs/api

API

GET /api/agent/status

Agent state, model, cache stats

Route group: Agent. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentgetapiagentstatus

References: /docs/api

API

POST /api/agent/message

Send message through agent pipeline

Route group: Agent. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentpostapiagentmessage

References: /docs/api

API

POST /api/agent/message/stream

Stream agent response as SSE events

Route group: Agent. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentpostapiagentmessagestream

References: /docs/api

API

GET /api/sessions/:id/turns

List all turns for a session

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapisessionsidturns

References: /docs/api

API

GET /api/turns/:id

Get single turn detail

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapiturnsid

References: /docs/api

API

GET /api/turns/:id/context

Get context snapshot for a turn

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapiturnsidcontext

References: /docs/api

API

GET /api/turns/:id/tools

Get tool calls for a turn

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapiturnsidtools

References: /docs/api

API

GET /api/turns/:id/tips

Get heuristic analysis tips for a turn

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapiturnsidtips

References: /docs/api

API

GET /api/turns/:id/model-selection

Get model selection details for a turn

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapiturnsidmodel-selection

References: /docs/api

API

POST /api/turns/:id/analyze

Trigger LLM-powered deep analysis

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorypostapiturnsidanalyze

References: /docs/api

API

GET /api/sessions/:id/insights

Get session-aggregate analysis

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorygetapisessionsidinsights

References: /docs/api

API

POST /api/sessions/:id/analyze

Trigger session-wide LLM analysis

Route group: Context Observatory. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpcontext observatorypostapisessionsidanalyze

References: /docs/api

API

POST /api/turns/:id/feedback

Submit a quality grade (1-5)

Route group: Feedback. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpfeedbackpostapiturnsidfeedback

References: /docs/api

API

GET /api/turns/:id/feedback

Get existing feedback for a turn

Route group: Feedback. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpfeedbackgetapiturnsidfeedback

References: /docs/api

API

PUT /api/turns/:id/feedback

Update a grade

Route group: Feedback. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpfeedbackputapiturnsidfeedback

References: /docs/api

API

GET /api/sessions/:id/feedback

Get all feedback for a session

Route group: Feedback. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpfeedbackgetapisessionsidfeedback

References: /docs/api

API

GET /api/recommendations

Get prioritized behavioral recommendations

Route group: Recommendations. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttprecommendationsgetapirecommendations

References: /docs/api

API

POST /api/recommendations/generate

Trigger LLM-powered deep recommendation analysis

Route group: Recommendations. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttprecommendationspostapirecommendationsgenerate

References: /docs/api

API

GET /api/wallet/balance

USDC + credit balance

Route group: Wallet. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpwalletgetapiwalletbalance

References: /docs/api

API

GET /api/wallet/address

Wallet address

Route group: Wallet. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpwalletgetapiwalletaddress

References: /docs/api

API

GET /api/skills

List all registered skills

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsgetapiskills

References: /docs/api

API

GET /api/skills/:id

Skill detail + content

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsgetapiskillsid

References: /docs/api

API

DELETE /api/skills/:id

Delete a skill

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsdeleteapiskillsid

References: /docs/api

API

POST /api/skills/reload

Trigger hot-reload from disk

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillspostapiskillsreload

References: /docs/api

API

PUT /api/skills/:id/toggle

Enable/disable a skill

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsputapiskillsidtoggle

References: /docs/api

API

GET /api/skills/catalog

List catalog skills (available to install)

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsgetapiskillscatalog

References: /docs/api

API

POST /api/skills/catalog/install

Install a skill from catalog

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillspostapiskillscataloginstall

References: /docs/api

API

POST /api/skills/catalog/activate

Activate an installed catalog skill

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillspostapiskillscatalogactivate

References: /docs/api

API

GET /api/skills/audit

Audit skill integrity

Route group: Skills. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpskillsgetapiskillsaudit

References: /docs/api

API

GET /api/plugins

List installed plugins

Route group: Plugins. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttppluginsgetapiplugins

References: /docs/api

API

PUT /api/plugins/:name/toggle

Enable/disable plugin

Route group: Plugins. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttppluginsputapipluginsnametoggle

References: /docs/api

API

POST /api/plugins/:name/execute/:tool

Execute a plugin tool

Route group: Plugins. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttppluginspostapipluginsnameexecutetool

References: /docs/api

API

GET /api/browser/status

Browser session status

Route group: Browser. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpbrowsergetapibrowserstatus

References: /docs/api

API

POST /api/browser/start

Start headless browser

Route group: Browser. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpbrowserpostapibrowserstart

References: /docs/api

API

POST /api/browser/stop

Stop browser session

Route group: Browser. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpbrowserpostapibrowserstop

References: /docs/api

API

POST /api/browser/action

Execute browser action

Route group: Browser. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpbrowserpostapibrowseraction

References: /docs/api

API

GET /api/agents

List agent instances

Route group: Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentsgetapiagents

References: /docs/api

API

POST /api/agents/:id/start

Start an agent

Route group: Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentspostapiagentsidstart

References: /docs/api

API

POST /api/agents/:id/stop

Stop an agent

Route group: Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpagentspostapiagentsidstop

References: /docs/api

API

GET /api/subagents

List sub-agent definitions

Route group: Sub-Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsub-agentsgetapisubagents

References: /docs/api

API

GET /api/subagents/:name

Sub-agent detail

Route group: Sub-Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsub-agentsgetapisubagentsname

References: /docs/api

API

PUT /api/subagents/:name/toggle

Enable/disable sub-agent

Route group: Sub-Agents. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpsub-agentsputapisubagentsnametoggle

References: /docs/api

API

GET /api/roster

List all agents with model assignments

Route group: Roster. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttprostergetapiroster

References: /docs/api

API

PUT /api/roster/:name/model

Change an agent's model assignment

Route group: Roster. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttprosterputapirosternamemodel

References: /docs/api

API

GET /api/approvals

List pending approval requests

Route group: Approvals. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpapprovalsgetapiapprovals

References: /docs/api

API

POST /api/approvals/:id/approve

Approve a pending request

Route group: Approvals. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpapprovalspostapiapprovalsidapprove

References: /docs/api

API

POST /api/approvals/:id/deny

Deny a pending request

Route group: Approvals. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpapprovalspostapiapprovalsiddeny

References: /docs/api

API

POST /api/interview/start

Start setup interview

Route group: Interview. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpinterviewpostapiinterviewstart

References: /docs/api

API

POST /api/interview/turn

Submit interview response

Route group: Interview. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpinterviewpostapiinterviewturn

References: /docs/api

API

POST /api/interview/finish

Finalize interview

Route group: Interview. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpinterviewpostapiinterviewfinish

References: /docs/api

API

GET /api/audit/policy/:turn_id

Policy audit for a turn

Route group: Audit. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpauditgetapiauditpolicyturn_id

References: /docs/api

API

GET /api/audit/tools/:turn_id

Tool audit for a turn

Route group: Audit. This endpoint is part of the documented API reference and is available through the runtime HTTP surface.

apihttpauditgetapiaudittoolsturn_id

References: /docs/api

API