Our workRunnerly
Platform engineering / CaeliCode project

One view of
the runner layer.

Self-hosted CI brings control over execution—and more infrastructure to understand. Runnerly connects runner state, job activity, and repository policy in one authenticated operating view.

Open RunnerlyDiscuss a similar challenge

GitHub sign-in required. Access is currently limited to the authorized operator.

runnerly.

By CaeliCode

Discipline
Platform engineering
Environment
Live, restricted CaeliCode workspace
Core systems
GitHub App · SQLite · live updates
Operating review
7 September 2026
Inside the workspace

Explore the proposed dashboard redesign. The live application remains access-controlled.

RunnerlyInterface preview
Runnerly workspace overview showing runner availability, current workload, recent jobs, and operating signals using sample data.
Understand the fleet and workload at a glance.

Product interface · Illustrative data · Private fleet details are not shown.

The challenge

“Online” doesn’t
tell the whole story.

An operator needs to connect the runner, the job, the repository, and the execution lane. Those answers can be scattered across GitHub events, inventory, and local knowledge.

The goal was to bring that context together while keeping GitHub in charge of scheduling. The operating view also needed to recover from missed events, respect repository boundaries, and retain records for investigation.

The engineering decisions

Built around
operating reality.

Each choice addresses a specific failure mode, with a deliberate limit to the system’s responsibility.

01

Events for speed.
Reconciliation for correction.

State management

Signed webhooks update the view quickly. Runner refresh and full reconciliation bring it back into line when events are delayed, missed, or out of date.

GitHub remains the source of truth. Runnerly maintains an operating record; it does not replace the scheduler.

02

Separate visibility
from execution rights.

Access & policy

GitHub sign-in and organisation authorisation protect the dashboard. Inside it, policy views distinguish public-repository telemetry from the restricted execution lanes used by private repositories.

Runner-group and repository settings in GitHub enforce execution access. The dashboard makes those boundaries visible.

03

Keep an operating record
close to the system.

Evidence & recovery

SQLite brings normalised jobs, events, and audit activity together. JSON and CSV exports support review, while local backup controls preserve copies of the record.

A local store keeps the staging deployment straightforward. High availability, offsite durability, and proven recovery remain separate work.

The demonstrated result

Connected context.
Usable operating records.

Observed in an authenticated review of the private staging system on 7 September 2026.

See the fleet in context

Real organisation-scoped runner records, labels, and state alongside repository and workflow inventory.

Review the execution boundary

GitHub events and policy views in the same signed-in operating surface.

Take the record with you

Working JSON/CSV evidence exports, audit views, and local backup controls.

Runnerly is a live CaeliCode engineering project with restricted GitHub authentication. The interface shown here is the proposed redesign, populated with sample data. It is not a customer case study.

Current scope

A working system.
A clear next boundary.

The operating review established the views and exports above. It did not establish a complete runner lifecycle or a production recovery objective.

What still needs to be proven
  • End-to-end runner registration and installation
  • Optional host-agent telemetry in sustained operation
  • Backup restoration against a defined recovery objective
What remains outside the demonstrated scope
  • Complete create, rotate, drain, and remove lifecycle
  • Signed agent enrollment and credential rotation
  • Highly available or multi-tenant operation
  • Offsite backup durability and tamper-evident records
Inside the implementation

The reasoning,
in full.

The engineering note documents authentication, state reconciliation, policy, and the remaining hardening work.

Read the Runnerly engineering note
A related challenge?

Make your delivery platform easier to operate.

We can help assess the runner architecture, access boundaries, and visibility your team needs.

Discuss your platform