Groundfloor Docs

Coderunner

List, inspect, and restart Coderunner instances when integration is configured.

This page documents a feature that requires external Coderunner configuration. The UI is live but needs CODERUNNER_URL and CODERUNNER_TOKEN set on Control Plane.

Pillar #9· Coderunner Mgmt UI⚠️ Scaffold

What it will do

Coderunner management lets you see running app instances, inspect status, restart runners, and jump to Process Log for live output.

What works today

When Coderunner is wired to Control Plane:

  • List runners filtered by workspace and app
  • View runner status and metadata
  • Restart button per runner
  • Link to Process Log with filters pre-filled

Prerequisites

Control Plane environment must have:

  • CODERUNNER_URL — Coderunner API base URL
  • CODERUNNER_TOKEN — service authentication token

Without these, the page shows an empty or unavailable state.

Portal location

Sidebar → Build → Coderunner, or workspace detail → Coderunners section.

  • GET /v1/workspaces/{id}/coderunners — list runners
  • POST /v1/workspaces/{id}/coderunners/{id}/restart — restart runner

Apps

Register and manage workspace apps — Shell federated publish is partially live; Coderunner deploy path deferred.

LLM Gateway

Workspace-scoped LLM virtual keys, model catalog, and usage billing via LiteLLM.

On this page

What it will doWhat works todayPrerequisitesPortal locationRelated docsRelated API