clai — command-line artifact interpreter

deterministic runtime for live systems.

runtime state changes. code evolves. debugging requires time-travel. maintaining continuity across these forces is difficult.

clai provides: same @handle across forge → exec → inspect → evolve. hot code replacement without restart. rollback by lineage node, not timestamp. parser-driven determinism from grammar to execution.

Interactive Runtime Demo

try real clai runtime. demonstrates handle continuity and lineage-based rollback.
license unlocks persistent CLI access.

license grants CLI access to hosted runtime. all execution is remote.

runtime demo

interactive scenarios demonstrating handle continuity and lineage-based rollback.

waiting for command...

parser source · run verification

parser-driven architecture

grammar defines execution. parser is source of truth. runtime emerges from deterministic dispatch.

PEG parser with canonical normalization — deterministic dispatch from grammar rules
handle continuity — same @handle persists across all transformations
lineage-based rollback — target causal nodes (L2, L3), not timestamps

parser: open source (MIT). parses, normalizes, validates grammar.
runtime: proprietary. proves determinism invariants hold across all four forces.

runtime capabilities

hot code replacement (RCU-based) — reload module code without restart, preserving process state
causal rollback — restore computational history by lineage node, not snapshots
process control — spawn, kill, wait, trace syscalls via exec lane
lua scripting — embed runtime in Lua for programmatic orchestration
remote execution — code runs on hosted infrastructure

runtime license

component	role	license
clai parser	parse + normalize	MIT
hosted runtime	remote execution (VPS)	licensed

$144 / year · $30 / month

subscription-based runtime access

payment

installation

curl -L https://clai.live/install.sh | sh
clai activate --key CLA1-XXXX-YYYY-ZZZZ

usage

clai forge:module.c test.c
clai exec:program.spawn ./app
clai exec:program.trace @pid
clai evolve:module.hotload new.so

verify hash match

both components publish manifest hashes for verification.
determinism verified: clai verify --hash ensures parser/runtime agreement.

examples

clai forge:module.c src/main.c
clai exec:program.spawn bin/app --as @A
clai exec:program.trace @A
clai inspect:mem.map @A --at program
clai evolve:module.hotload alloc.so
clai snapshot:snapshot.write state.jsonl

lanes

forge — compile C source, create artifacts
exec — spawn/kill/wait/trace processes
inspect — read memory maps, process state
evolve — mutate code transactionally, rollback by lineage

feedback

report issues, suggest features, or share usage experience.