CONTROL
Approval is a real gate
A proposal does not start work. Explicit approval compiles an immutable plan; dispatch and deterministic execution are checked against that plan.
Workflow lifecycle Local-first MCP runtime
Make agent work
durable by design.
Runalith turns multi-step agent work into explicit plans, recoverable state, and evidence you can verify—not just a confident final answer.
WORKFLOW / 0042
01
ProposalDefine scope & intent
DRAFT02
Immutable planApproval recorded
✓03
Evidence checksArtifacts · lineage · exit
01Approval before actionIntended work is explicit
02State that survivesDurable records, not chat history
03Completion by evidenceProof beats assertion
THE RUNTIME
Orchestration with
clear boundaries.
Runalith keeps planning, authorization, execution, and acceptance distinct. Each stage leaves durable state that can be inspected when work succeeds, fails, or needs recovery.
PERSISTENCE
Durable local state
Tasks, approvals, results, artifacts, and audit events are recorded in SQLite for inspection and recovery.
ArchitectureVERIFICATION
Evidence over assertions
Typed artifact schemas, producer lineage, execution results, and supported success predicates feed completion gates.
Batch executionRECOVERY
Failures stay visible
Unknown or incomplete outcomes remain blocked until durable evidence supports a safe next step. Retries preserve plan and provenance.
Known issuesA WORKFLOW, NOT A PROMPT CHAIN
One traceable path
from intent to outcome.
01
Propose
Record a bounded request and its intended work.
02
Approve
Review the plan and make authorization explicit.
03
Execute
Release dependency-ready work under its planned contract.
04
Verify
Check task state, typed evidence and completion conditions.
05
Recover or finish
Persist a truthful terminal status and auditable history.
BUILT FOR MCP
Standard bundle.
Local-first runtime.
The `.mcpb` file is a bundle container for compatible MCP clients. Runalith also supports direct stdio integration, so the package format and the client are separate choices.
mcp server configJSON
{
"mcpServers": {
"runalith": {
"command": "node",
"args": [
"/path/to/runalith/server/index.js"
],
"env": {
"RUNALITH_WORKSPACE": "/path/to/workspace"
}
}
}
}STDIO · LOCAL PROCESSNO HOSTED RUNNER
TRY THE PROJECT
Explore the code.
Verify the package.
Read the source, run the acceptance suite, or download an explicitly experimental release. Testing artifacts are not production certifications.
Testing releases are experimental, not production certifications. Verify the downloaded package checksum and read the release notes before installation.