PuterVision
In-Browser ~60Hz Behavior Tree Execution
Deterministic, low-latency action execution inside browser runtimes with reactive interrupt triggers, telemetry recordings, and 5-layer safety guardrails.
*Functional agency and closed-loop automation — not consciousness, sentience, or AGI.*
⚡ Interactive Behavior Tree Step Simulator
Step through a live behavior tree tick loop. Drop HP below 30 to see the reactive trigger preempt the combat sequence and engage the emergency heal branch.
Execution Log
🛠️ Consolidated MCP Tools (10 Tools)
Deterministic, low-latency execution tools for high-frequency browser and desktop behavior control.
load_behavior
Inject and start behavior tree execution loop inside target browser runtimes.
set_parameters
Dynamically update runtime execution variables and tuning flags on the fly.
get_status
Query active execution status, active node traversal path, and tick counters.
abort_behavior
Immediately halt, pause, or resume execution and release active browser inputs.
register_trigger
Configure priority interrupt triggers with cooldown guards and branch preemption.
replay_recording
Capture and deterministically replay synchronized browser frame action sequences.
get_metrics
Retrieve runtime execution telemetry, tick durations, stuck events, and stats.
manage_behaviors
Register, version, and query immutable JSON tree definitions with SHA-256 validation.
manage_blackboard
Read, write, and query shared behavior tree blackboard state variables.
manage_runtime_db
Database diagnostics, checkpoints save/restore, and SHA-256 Merkle audit verification.
🛡️ 5-Layer Behavioral Safety Stack
Production-grade execution guardrails guaranteeing stability, browser thread safety, and immediate emergency disengagement.
⏱️ 1. Token Bucket Rate Limiting
Strict frequency guards enforce tick intervals up to 60Hz. Burst dampening prevents event-loop starvation and runaway browser DOM manipulation spikes.
🔍 2. Stuck State Detection
Heuristic cycle detectors and stationary watchdogs identify repeated failure sequences, deadlocked nodes, or idle loops within 500ms, triggering recovery branches.
💀 3. Dead-Man Watchdog
Constant client heartbeat requirement. If a communication gap or unhandled crash exceeds 2000ms, all active keys, mouse buttons, and browser inputs disengage immediately.
🚪 4. Policy Gate Verification
All action payloads pass deterministic security boundary checks (domain whitelisting, prohibited selector blacklists, destructive mutation guards) before entering the tick queue.
📜 5. SHA-256 Merkle Audit Trail
Every tree definition, trigger activation, parameter hot-swap, and abortion event is cryptographically hashed and chained into a tamper-evident audit log for post-mortem forensics.
🚀 Quickstart & Client Integration
Integrate behavior-mcp into your AI coding assistant with zero external dependencies.
1. Global Installation
Install globally via npm for CLI and server usage:
2. Client Configurations
Claude Code CLI
Cursor IDE (.cursor/mcp.json)
Gemini CLI
3. Health & Runtime Verification
Verify installation and audit runtime database health: