VVM

Vibe Virtual Machine is a DSL for agentic workflows where the LLM is the runtime.

VVM gives you:

• explicit agent boundaries (@agent ...)
• semantic control flow (?, match, choose)
• explicit concurrency (pmap, parallel(join=..., on_fail=...))
• reusable workflow contracts (input, export, callable modules)
• scalable state backends (in-context, filesystem, sqlite, postgres)

The language spec is in skills/vvm/spec.md (v0.0.4).

Quick Start

Install as a Claude Code plugin:

claude plugin marketplace add https://github.com/karanchawla/vvm.git
claude plugin install vvm@vvm

Then:

/vvm-boot
/vvm-compile examples/01-hello-world.vvm
/vvm-run examples/01-hello-world.vvm

For scalable runs:

/vvm-run examples/39-pr-babysitter.vvm --state=filesystem
/vvm-run examples/38-rlm-diff-time-machine.vvm --state=sqlite

Minimal Example

input topic: "Topic to research"

agent researcher(model="sonnet", prompt="Research expert.")
agent writer(model="sonnet", prompt="Clear technical writer.")

research = @researcher `Research {topic} and cite evidence.`(topic)
report = @writer `Write an executive summary.`(research)

export report

Command Surface

See command docs in commands/.

State Backends

Backends are selected with --state=... on /vvm-run.

Remote Modules and Registry

VVM supports:

• local modules: from "./lib/x.vvm" import ...
• URL modules: from "https://..." import ...
• registry shorthand: from "@handle/slug" import ...

Use:

• --offline / --cache-only for cache-only resolution
• /vvm-registry-inspect to inspect contracts before execution

Examples

Examples are in examples/, with an up-to-date index in examples/README.md.

Current catalog includes:

• fundamentals (01-13, 15-20)
• multi-agent orchestration (21-23, 32-35, 39)
• memory and ref/state patterns (24-31)
• workflow contracts/modules (36-37)
• recursive language model pattern (38)

Repository Layout

Status and Safety

VVM is still evolving. Validate with /vvm-compile before running large workflows, and run high-impact automations with tight permissions and review gates.

License

MIT

{
  "name": "vvm",
  "owner": {
    "name": "Karan Chawla",
    "url": "https://github.com/karanchawla"
  },
  "plugins": [
    {
      "name": "vvm",
      "source": "./",
      "description": "A DSL for agentic workflows where the LLM is the runtime"
    }
  ]
}