Runtime Lifecycle

How Kendr Works

Kendr is built around a real runtime, not a loose chain of prompts. Requests move through discovery, planning, execution control, and saved state.

The Runtime Lifecycle

Every request moves through the same structured control plane before it becomes an answer, artifact, or governed action.

1

Input Acquisition

Input arrives through CLI, gateway, or Web UI carrying context like working directory, project root, channel/session metadata, and optional workflow hints.

CLI HTTP Gateway Web UI
πŸ“₯
2

Registry Build & Setup Snapshot

The runtime builds a unified registry of available capabilities, then applies a setup snapshot so only eligible actions remain available.

Built-in

20+

task agents

Plugins

∞

via ./plugins

MCP

∞

synthetic agents

Models

Multi

execution lanes

3

Intent Discovery & Policy Routing

Once the eligible surface is known, Kendr classifies the request and chooses the right lane: direct tools, explicit workflows, or planner-driven execution. This is where the runtime stops being generic chat.

βœ“ deepresearch_agentconfigured
βœ“ local_drive_agentconfigured
βœ“ superrag_agentconfigured
~ slack_agentmissing SLACK_TOKEN
βœ— aws_agentnot configured
4

State Construction & Workflow Typing

A typed RuntimeState is constructed. The runtime decides whether this is deep research, local-drive, superRAG, project workbench, OS command, long-document, or general planning work.

deep_research long_document superrag local_drive project_workbench general_planning
5

Planning & Approval Policy

Planner-backed runs are safety-classified. Conservative read-only plans can auto-approve, while risky or mutating work pauses for human review before any consequential action is taken.

⏸️

Approval Required

The orchestrator has planned a 4-step workflow that includes file writes and 3 external API calls. Review and approve to continue.

6

Execution Lanes & Persistence

Kendr executes safe read-only batches in parallel where possible and keeps risky or write-heavy work serialized. Each step records messages, artifacts, work notes, session state, and orchestration events into SQLite.

Messages

All agent outputs stored

Artifacts

Files and data outputs

Execution trace

Full step-by-step log

Checkpoints

Resumable state snapshots

Session state

Context continuity

Run manifest

Complete run summary

7

Completion or Safe Recovery

On completion, the runtime writes final outputs, session summaries, and manifests. On failure, a recovery checkpoint allows safe resume from the last stable state. Nothing is lost.

βœ“ Clean completion ↩ Checkpoint resume Durable artifacts always written

Six Architecture Planes

Under the hood, Kendr is split into six layers that keep research, execution, and memory working together.

πŸ–₯️

Interface Plane

CLI, Gateway HTTP surface, Web UI, and Project Workbench UI β€” all backed by the same runtime engine.

βš™οΈ

Runtime / Orchestration Plane

State initialization, workflow typing, planning, approvals, execution control, recovery.

πŸ”Œ

Capability Plane

Built-in agents, plugin agents, and tool capabilities unified in one registry.

🧠

Knowledge Plane

Local-drive ingestion, OCR, vector search, superRAG sessions, source-aware synthesis.

πŸ’Ύ

Persistence & Memory Plane

SQLite-backed runs, tasks, artifacts, sessions, checkpoints. File-based agent memory that's human-readable.

πŸ›‘οΈ

Governance Plane

Setup-aware controls, scoped security, checkpoints, kill-switch support.

Ready to install Kendr?