Runtime

The local supervisor that executes installed agents — injecting tools, enforcing permissions, probing health, and recovering crashes.

The runtime is a separate process from the registry, and it runs on your machine. It is what turns an installed manifest into a live process and keeps it alive.

What the supervisor does

  • Detects the runtime — node, python, or an http tool — from the manifest.
  • Injects tools and environment — only what the manifest declares, nothing more.
  • Validates permissions — a declared permission is granted; an undeclared capability is not.
  • Probes health on an interval, and restarts crashes with a loop cap so a failing agent cannot spin forever.

Status vs. health

These are two axes, deliberately separate. Status is what the supervisor is doing with the process (running, stopped, failed,restarting). Health is what the agent reports about itself (healthy, unhealthy). A process can be running and unhealthy at the same time — and knowing that is the point.

Running agents

$ norien runtime start$ norien run research-agent$ norien status$ norien restart research-agent$ norien stop research-agent
CarefulThe runtime executes code, so it is intentionally local-only. In the hosted app the runtime page shows the registry and chain status (both live) and explains how to start the supervisor yourself — see Running agents.