Eva-CLI Multi-Agent Runtime
Language
English 简体中文

Open source agent runtime

Eva-CLI

A controlled runtime for multi-Agent automation

Eva-CLI uses Rust for reliable runtime boundaries and Lua for hot-reloadable Agent behavior, then connects external Agents, MCP servers, skills, memory, knowledge bases, and hardware through a unified Topic EventBus.

Rust runtime boundary Lua hot reload Topic EventBus
Read the docs Architecture overview Development progress Discussion Feedback

Development progress

From architecture scaffold to release evidence, operator safety, and closure gates

Remaining work
Current stage

V1.17.6 V1.x closure release gate is in place

The repository keeps the V1.11.5-alpha source version while documenting and gating the completed V1.12 to V1.17 runtime evidence line: daemon control and recovery, provider supervision gates, restore mutation and rollback evidence, service-manager abstraction, hardware safety gates, memory retrieval and redaction, observability retention policy, run command split, operator execution fields, high-risk text summaries, public JSON contract diff validation, and the V1.x closure report.

  1. Done
    Architecture, module partitioning, and configuration

    System boundaries, runtime model, adapters, memory, discovery, hardware, recovery, website, docs, configuration, and module partitioning are in place.

  2. Done
    Runnable V1.0 runtime and task diagnostics

    The in-memory basic loop, CLI quickstart, local task status/log/cancel diagnostics, and core CI checks are implemented.

  3. Done
    V1.1 to V1.5.1 controlled capability, release gates, and GHCR delivery

    External capability diagnostics, memory context, hardware plans, backup/lifecycle checks, release hardening commands, the source user manual, and GitHub Packages container delivery are implemented.

  4. Now
    V1.17.6 V1.x closure release gate

    The V1.12 daemon, V1.13 provider, V1.14 restore/service-manager, V1.15 hardware and memory, V1.16 observability, and V1.17 CLI/operator contract evidence lines are summarized by the closure gate and synchronized across website, docs, release notes, and i18n manifest.

  5. Later
    Signed installers, provenance, and real apply paths

    Future releases add provider process execution, durable stores, destructive apply gates, signed installers, OS packages, and provenance bundles.

Next implementation work
  • Resolve production signing, attestation, OS package publication, and release upload blockers when credentials and repository permissions exist.
  • Attach platform service-manager test environments, real hardware fixtures, and production database sink evidence before claiming production readiness.
  • Keep high-risk restore, upgrade, hardware, and lifecycle paths behind explicit evidence, confirmation gates, and stable JSON contracts.

Recommended reading

Open blog

Follow the implementation thinking behind Eva-CLI: runtime boundaries, LuaAgent tooling, product direction, and controlled automation design.

Architecture

From runtime boundary to controlled capabilities

Eva-CLI architecture diagram

Docs

Read by usage and architecture topic

User Manual Install from source, validate config, run the basic loop, inspect task diagnostics, run release gates, and understand the current plan-first safety boundary. Architecture Overview Current module boundaries, command-specific runtime flows, safety invariants, state ownership, and production blockers. Module Partitioning The landed Rust workspace shape, crate boundaries, dependency direction, runtime handoffs, and ownership rules. Single-Process Runtime and EventBus Synchronous EventBus delivery, bounded Scheduler mailboxes, Lua 5.4 execution, and foreground daemon boundaries. Dynamic Adapter Layer Controlled access to external Agents, CLI tools, HTTP services, MCP servers, skills, and hardware. Lua Capability Runtime Hot-reloadable Tool, Skill, and MCP handler behavior with Rust-owned permissions and rollback. Skill Implementation How workflow Skills, runtime workers, and Lua Skills become controlled workflow capabilities. Memory and Knowledge Runtime-owned memory facts, knowledge retrieval, ContextBuilder policy, and Lua API boundaries. Discovery and Registration How Agents, adapters, MCP servers, skills, and Lua capabilities are discovered and validated. IDEA Plugin Toolchain Developer tooling requirements for project indexing, Lua Agent editing, Runtime Bridge validation, dry runs, traces, and policy diagnostics. V1.5 Release Hardening (Historical) A historical v1.5.0 record that separates compiled declarations and fixtures from optional evidence and executed CI. GitHub Packages Publishing The implemented GHCR sequence, digest identity, evidence semantics, permissions, consumer checks, and post-push failure boundary. Install, Upgrade, And Uninstall Manual archive acquisition, checksum verification, extraction, replacement, removal, and retained project-data boundaries. V1.11.5 Alpha Tag Notes The tagged emit, Agent, and capability checkpoint whose Ubuntu verification failed before package, archive, or GitHub Release publication. V1.11.4 Alpha Release Notes The alpha prerelease that fixes version metadata on the CLI module split checkpoint, adds release notes, and aligns release readiness evidence with the V1.11.4 tag. V1.7.4 Alpha Release Notes The alpha prerelease that adds Lua shadow-load health checks, generation route gating, drain evidence, rollback audit evidence, and the Lua hot-reload lifecycle release gate. V1.7.3 Alpha Release Notes The alpha prerelease that adds Lua wall-clock timeout, instruction budget, cancellation token, memory budget, and the Lua resource limits release gate. V1.7.2 Alpha Release Notes The alpha prerelease that adds read-only Lua ctx tables, host log/audit observations, ctx.tools.call capability binding, and the Lua host bindings release gate. V1.7.1 Alpha Release Notes The alpha prerelease that adds the restricted Lua VM execution boundary, on_event(ctx) execution, stable Lua error mapping, and the Lua VM release gate. V1.6.5 Alpha Release Notes The alpha prerelease that adds durable backend diagnostics, inspect.durable JSON output, pending redrive counts, and CI/release smoke coverage. V1.6.4 Alpha Release Notes The alpha prerelease that adds runtime recovery scanning, ack-safe event redrive, durable recovery audit records, and the recovery release gate. V1.6.3 Alpha Release Notes The alpha prerelease that adds durable task snapshots, durable audit records, and artifact metadata hardening. V1.6.2 Alpha Release Notes The alpha prerelease that adds filesystem EventLog, DurableEventBus, queryable dead-letter storage, and durable redrive evidence. V1.6.1 Alpha Release Notes The alpha prerelease that starts the durable runtime/storage line with the backend manifest, layout, and migration-lock baseline. V1.5.1 Release Notes The patch release that keeps V1.5 contracts stable while enabling GitHub Packages delivery through GHCR.

Discussion

Discuss Eva-CLI

Ask questions, share implementation ideas, or leave design feedback through GitHub Discussions.