Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JEVULON VII (JVII)

npm version License: MIT TypeScript Node.js

Run coding agents in true parallel. Faster, cheaper, zero quality loss.

Normal multi-agent setups just open multiple terminal tabs at once, burning thousands of tokens arguing about who does what and constantly overwriting each other's code.

JEVULON VII is the first true parallel framework for AI coding agents. By combining instant System-1 task routing with live whiteboard file locking (board.json), your Claude Code, Cursor, Codex, and LangGraph agents work in true parallel (from 2 agents to a full swarm) with zero file overwrites and zero wasted supervisor chat tokens.


Quickstart

You don't need an account or API key to start coordinating agents locally.

1. Run via npx

npx -y jevulon

2. Connect to Cursor or Claude Desktop (MCP)

Add JEVULON VII to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "jvii": {
      "command": "npx",
      "args": ["-y", "jevulon"]
    }
  }
}

Once connected, your agents automatically gain access to the coordination tools:

  • sentinel_presence: Claims files before editing and checks for workspace collisions.
  • sentinel_shield_inspect: Deterministic zero-latency policy floor guarding destructive commands.
  • sentinel_supervise: Autonomous wave dispatch, worker recovery, and completion verification.

Architecture: System-1 vs. System-2

Most multi-agent frameworks use System-2 LLM supervisors (chatty conversational models like GPT-4 or Claude 3.5 Sonnet) to coordinate workers. This burns thousands of tokens per minute, takes 10–15 seconds per coordination turn, and frequently hallucinates file states.

JEVULON VII decouples execution into two specialized layers:

┌────────────────────────────────────────────────────────┐
│  SYSTEM-2 WORKERS (Claude Code, Cursor, Codex)         │
│  Thinks, plans, and writes code inside your workspace  │
└───────────────────────────┬────────────────────────────┘
                            │ (Claims files / Asks gates)
                            ▼
┌────────────────────────────────────────────────────────┐
│  SYSTEM-1 CONTROL LAYER (JEVULON VII)                  │
│  ● Deterministic file locking (board.json)             │
│  ● Zero-latency offline safety floor (0ms)             │
│  ● Sub-second categorical decision gates (~500ms)      │
│  ● $0 wasted on supervisor conversation                │
└────────────────────────────────────────────────────────┘

Core Capabilities

1. Deterministic Conflict Prevention

Before an agent edits any file, it registers an atomic claim on the shared board. If sibling agents attempt to modify overlapping files or dependent interfaces, JEVULON VII negotiates priority and prevents overwriting code before it happens.

2. Zero-Egress Offline Safety Floor

A 77-case deterministic safety engine blocks destructive shell commands (rm -rf, raw disk wipes, credential exfiltration, base64 payload piping) locally in 0ms without sending your code to any external network.

3. Native LangGraph Drop-in Integration

Integrate directly into LangGraph StateGraphs as a supervisor, router, or safety middleware without restructuring your workflow:

import { createSupervisorNode, createShieldMiddleware } from "jevulon/langgraph";

// Add zero-token deterministic safety middleware to your graph
const shieldMiddleware = createShieldMiddleware({
  onBlock: "halt",
  onEscalate: "human_review"
});

4. Pluggable Decision Seam (BYOK)

Implements a structural DecisionEngine seam (choice and noul in src/engine.ts). Connect your own TypeSafe JEV keys, local Ollama/vLLM models, or use the built-in deterministic simulation engine.


Enterprise & Private VPC Deployment

For enterprise teams with strict compliance or zero-external-egress mandates, a pre-hardened multi-container Docker Compose bundle is available:

https://github.com/Jason-Fay/jevulon-docker

curl -sSL https://jevulon.com/deploy/docker.tar.gz | tar -xz && docker compose up -d

Testing & Verification

JEVULON VII maintains a rigorous test suite covering the deterministic floor, stigmergy, MCP servers, and circuit breakers:

git clone https://github.com/Jason-Fay/jevulon.git
cd jevulon
npm install
npm test

License

MIT © 2026 MetaWave / Jason Fay. See LICENSE for details.

About

Run AI coding agents in true parallel. Faster, cheaper, zero quality loss. Shared whiteboard file locking and System-1 routing for Claude Code, Cursor, Codex, and LangGraph.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages