Skip to content

vmblu logo

Architecture for humans and agents

Visual.
Runnable.
Navigable.

Observable by design

vmblu VS Code extension screen movie
vmblu visual architecture

vmblu is for developers who understand that AI changes software itself
and that architecture, not code, is now their primary responsibility

BlueprintExecutable architecture
vmblu is a collection of tools, formats and prompts designed to build, understand and maintain serious software created with coding agents.

vmblu centers around a blueprint: a structured, machine-readable architectural model that defines nodes, routes, and contracts. The blueprint is the authoritative source — for code generation, testing, runtime behavior, and agent interaction. Everything else derives from it.
MessagesClear contracts
The editor tracks every message sent and received, making contracts a single source of truth for humans and agents. Generators and handlers stay aligned—no drift, no undocumented payloads, no “tribal knowledge”.
RunnableThe model is the system
A vmblu blueprint is not documentation—it’s executable. Code is generated from the model, and the vmblu runtime routes messages between nodes with low overhead. You can run, inspect, and test the system from the same architecture source.
TestingBuilding trust
vmblu encourages node-level testing by default: agents generate harnesses, execute tests per node, and produce a report. Contracts are checked formally at message boundaries, and failures stay local—so the blast radius of bad code is contained
SecurityRuntime-enforced policy
Nodes can be assigned capabilities (network, filesystem, process execution, etc.) enforced by the vmblu runtime. If a node lacks permission, the action is blocked at runtime—deny by default, with a clear audit trail
AI-nativeBuilt for agent collaboration
vmblu is designed for agent collaboration: the blueprint is machine-readable, contracts are explicit, and the system is navigable. Node interfaces can be exposed as tools via MCP, enabling a flexible natural-language interface on top of the same architecture.
VisualNodes, pins, routes
vmblu models a system as nodes connected by explicit routes. Nodes communicate through pins with formal message contracts—easy to trace, easy to review. The result reads like a circuit diagram: you see the system instantly and can reason about change safely.
ToolSeamless integration
vmblu fits into an existing workflow—you keep your preferred frameworks and libraries. It ships as a VS Code extension today, with other IDEs to follow
LicenseOpen source
vmblu is released under the Apache-2.0 license—permissive and business-friendly. Use it, modify it, and ship commercial products. Contributions remain open so the ecosystem can grow.