Skip to content
@putervision

PuterVision

PuterVision 👁️⚡

The Cognitive Pentad for Autonomous AI Agents — Local-first Model Context Protocol (MCP) infrastructure providing persistent state memory, perceptual vision caching, 3D/2D spatial world models, strategic BDI reasoning, and high-frequency behavior execution.

Organization Protocol Architecture Privacy


🌐 Overview

PuterVision engineers high-performance, zero-telemetry, local-first infrastructure and Model Context Protocol (MCP) servers for autonomous AI agents, coding assistants, and browser automation runtimes.

Modern frontier LLMs possess extraordinary semantic reasoning but suffer from three fundamental limitations: stateless ephemeral contexts, visual token bloat, and lack of physical and behavioral grounding.

The PuterVision Cognitive Pentad solves this by establishing a modular, local-first cognitive architecture where perception, memory, spatial world models, high-order deliberation, and reactive execution work in harmonious synergy—all powered by local SQLite, zero cloud dependencies, and sub-millisecond MCP dispatch.


🧠 The PuterVision Cognitive Pentad

flowchart TD
    subgraph Perception ["1. Perception & Grounding"]
        VM["👁️ vision-memory-mcp<br/>Perceptual Cache & Grounding"]
    end

    subgraph Spatial ["2. Spatial World Model"]
        WM["🌐 world-model-mcp<br/>3D/2D Spatial Memory & Frustum"]
    end

    subgraph State ["3. Workflow State Memory"]
        SM["💾 state-memory-mcp<br/>Task DAGs, Decisions & Graph RAG"]
    end

    subgraph Cognition ["4. Strategic Deliberation"]
        AR["🧭 agent-reasoning-mcp<br/>BDI Planning, Utility & Risk"]
    end

    subgraph Execution ["5. High-Frequency Runtime"]
        BM["⚡ behavior-mcp<br/>~60Hz Behavior Trees & Safety Stack"]
    end

    VM -->|Visual Grounding & AX Detections| WM
    VM -->|Visual Proof & State Hashes| SM
    WM -->|Spatial Map & Entity Proximity| AR
    SM -->|Active Goals, Plans & Blockers| AR
    AR -->|Action Directives & Intentions| BM
    BM -->|Execution Telemetry & Outcomes| SM
    BM -->|Action Feedback & Obstacles| AR
Loading

Key Open-Source Pentad MCP Servers

Project Badges Focus & Capabilities Links
state-memory-mcp npm Persistent Workflow State Memory
Zero-infrastructure, deterministic property graph backed by local SQLite. Eliminates AI amnesia by tracking tasks, decisions, artifacts, plans, and blockers with FTS5 RAG, DAG cycle detection, and an interactive WebGL 3D graph visualizer.
GitHubnpmWebsite
vision-memory-mcp npm Visual Memory & Perceptual Grounding
Local-first perceptual cache using perceptual hashing (dHash/pHash), CLIP vector embeddings, AX tree element grounding, and UI transition graphs. Eliminates up to 90% of redundant LLM vision calls while ensuring deterministic target coordinates.
GitHubnpmWebsite
world-model-mcp npm 3D/2D Spatial World Model
Deterministic spatial internal world model for AI agents. Features entity tracking, object permanence across view occlusions, AABB collision prediction, navigation waypoints, and camera frustum field-of-view calculation.
GitHubnpmWebsite
agent-reasoning-mcp npm Strategic BDI Cognitive Engine
Belief-Desire-Intention cognitive deliberation framework. Decomposes high-level objectives into dependency DAGs, calculates multi-objective utility scores, quantifies risk, maintains confidence-decayed beliefs, and executes adaptive replanning.
GitHubnpmWebsite
behavior-mcp npm ~60Hz Behavior Tree Execution Engine
High-frequency in-browser behavior tree runtime for deterministic browser automation and game AI. Features priority reactive interrupts, a 5-layer fail-closed safety stack, telemetry capture, and deterministic action sequence replay.
GitHubnpmWebsite

📦 Additional Projects & Supporting Libraries

Beyond the Core Pentad MCP servers, PuterVision develops specialized security, cryptographic, static analysis, and utility libraries:

Project Description Links
spc (Space Proof Code) High-performance, zero-dependency static analysis tool enforcing NASA Power of Ten safety-critical coding standards and security invariants across 20+ programming languages. GitHubnpm
WebCrypt Zero-dependency cryptographic vault suite for browser & Node.js Web Crypto API. Powers AES-256-GCM symmetric encryption, RSA-4096 hybrid public-key encryption, ECDH, digital signatures, and post-quantum security. GitHubnpmDemo
ScreenChunk High-resolution screen capture, spatial chunking, and visual layout partitioning engine for dense browser and desktop interfaces. Website
BassMusic.ai Client-side, browser-native algorithmic and neural music generator demonstrating zero-server Web Audio processing. Website

🛡️ Architectural Pillars

  • 🔒 100% Local-First & Zero Telemetry: Your code, tasks, visual captures, spatial entities, and belief states reside strictly in local SQLite and memory caches. Zero cloud dependencies, zero external analytics, and zero data leakage.
  • Sub-Millisecond Retrieval & Execution: Eliminates massive context window token burn. High-frequency indexing, perceptual hashing, and local graph traversal deliver deterministic responses in <2ms.
  • 🛡️ Safety-Critical & Cryptographically Verifiable: Engineered with fail-closed safety gates, watchdog circuit breakers, and SHA-256 Merkle audit chains for reproducible, tamper-proof agent trajectories.
  • 🔌 Universal MCP Compatibility: Natively supported by Claude Code, Cursor, Gemini CLI, Windsurf, VS Code, and any Model Context Protocol compliant client.

⚡ Quickstart: Adding the Pentad to Your AI Assistant

Add the PuterVision Pentad servers to your favorite MCP-enabled editor or agent environment:

Claude Code (claude.json) / Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "state-memory-mcp": {
      "command": "npx",
      "args": ["-y", "@putervision/state-memory-mcp"]
    },
    "vision-memory-mcp": {
      "command": "npx",
      "args": ["-y", "@putervision/vision-memory-mcp"]
    },
    "world-model-mcp": {
      "command": "npx",
      "args": ["-y", "@putervision/world-model-mcp"]
    },
    "agent-reasoning-mcp": {
      "command": "npx",
      "args": ["-y", "@putervision/agent-reasoning-mcp"]
    },
    "behavior-mcp": {
      "command": "npx",
      "args": ["-y", "@putervision/behavior-mcp"]
    }
  }
}

🔗 Connect & Resources

Popular repositories Loading

  1. state-memory-mcp state-memory-mcp Public

    Persistent, branch-aware workflow state memory MCP server for AI coding assistants. Tracks tasks, accepted decisions, and active blockers to prevent session context bloat and speed up development.

    TypeScript 88 1

  2. vision-memory-mcp vision-memory-mcp Public

    Persistent visual cache for LLM-driven software development. Caches screenshots using perceptual hashing, vector search, and AX trees to prevent token overhead and visual hallucination loops.

    TypeScript 69 1

  3. spc spc Public

    High-performance zero-dependency static analysis tool enforcing NASA Power of Ten rules across 20 programming languages, plus AI agent skill, MCP server config, prompt template, and LLM model secur…

    JavaScript 41

  4. WebCrypt WebCrypt Public

    Zero-dependency Web Crypto suite & Model Context Protocol (MCP) server for AES-256-GCM, RSA-4096, and AI agent security.

    JavaScript 29 5

  5. world-model-mcp world-model-mcp Public

    🌐 Persistent 3D/2D spatial world model MCP server for AI agents. Entity tracking, object permanence, AABB collision simulation & view frustum projection via local SQLite.

    TypeScript 8

  6. grokjs grokjs Public

    High-performance, zero-dependency JS/TS Language Model & NLP suite for Node.js and browsers featuring text generation, self-attention heatmaps, RAG fact injection, and webpage autocomplete.

    JavaScript 2

Repositories

Showing 10 of 11 repositories
  • behavior-mcp Public

    ⚡ High-frequency (~60Hz) in-browser behavior tree execution engine for autonomous AI agents. Reactive priority interrupts, safety guardrails & deterministic action replay over MCP.

    putervision/behavior-mcp's past year of commit activity
    TypeScript 2 MIT 0 0 0 Updated Sep 10, 2026
  • agent-reasoning-mcp Public

    🧭 Strategic BDI cognitive reasoning engine for AI agents. Goal decomposition DAGs, multi-factor utility scoring, risk evaluation, and adaptive replanning over MCP.

    putervision/agent-reasoning-mcp's past year of commit activity
    TypeScript 2 MIT 0 0 0 Updated Sep 10, 2026
  • world-model-mcp Public

    🌐 Persistent 3D/2D spatial world model MCP server for AI agents. Entity tracking, object permanence, AABB collision simulation & view frustum projection via local SQLite.

    putervision/world-model-mcp's past year of commit activity
    TypeScript 8 MIT 0 0 0 Updated Sep 10, 2026
  • state-memory-mcp Public

    Persistent, branch-aware workflow state memory MCP server for AI coding assistants. Tracks tasks, accepted decisions, and active blockers to prevent session context bloat and speed up development.

    putervision/state-memory-mcp's past year of commit activity
    TypeScript 88 MIT 1 0 0 Updated Sep 10, 2026
  • vision-memory-mcp Public

    Persistent visual cache for LLM-driven software development. Caches screenshots using perceptual hashing, vector search, and AX trees to prevent token overhead and visual hallucination loops.

    putervision/vision-memory-mcp's past year of commit activity
    TypeScript 69 1 0 6 Updated Sep 10, 2026
  • .github Public
    putervision/.github's past year of commit activity
    0 0 0 0 Updated Sep 10, 2026
  • WebCrypt Public

    Zero-dependency Web Crypto suite & Model Context Protocol (MCP) server for AES-256-GCM, RSA-4096, and AI agent security.

    putervision/WebCrypt's past year of commit activity
    JavaScript 29 MIT 5 0 0 Updated Aug 21, 2026
  • spc Public

    High-performance zero-dependency static analysis tool enforcing NASA Power of Ten rules across 20 programming languages, plus AI agent skill, MCP server config, prompt template, and LLM model security auditing.

    putervision/spc's past year of commit activity
    JavaScript 41 MIT 0 0 0 Updated Aug 21, 2026
  • grokjs Public

    High-performance, zero-dependency JS/TS Language Model & NLP suite for Node.js and browsers featuring text generation, self-attention heatmaps, RAG fact injection, and webpage autocomplete.

    putervision/grokjs's past year of commit activity
    JavaScript 2 MIT 0 0 0 Updated Aug 1, 2026
  • screenchunk-extension Public

    screenchunk browser extension

    putervision/screenchunk-extension's past year of commit activity
    0 0 0 0 Updated Jul 31, 2026

Top languages

Loading…

Most used topics

Loading…