ucsandman / DashClaw

DashClaw Decision Infrastructure for AI agents. Stop agents before they make expensive mistakes. Try it in 10 seconds npx dashclaw-demo No setup. Opens Decision Replay automatically. Works with: LangChain • CrewAI • OpenClaw • OpenAI • Anthropic • AutoGen • Claude Code • Codex • Gemini CLI • Custom agents Intercept decisions. Enforce policies. Record evidence. Agent → DashClaw → External Systems DashClaw sits between your agents and your external systems. It evaluates policies before an agent action executes and records verifiable evidence of every decision. View Live Demo --- What is DashClaw? DashClaw is not observability. It is **control before execution**. AI agents generate actions from goals and context. They do not follow deterministic code paths. Therefore debugging alone is insufficient. **Agents require governance.** DashClaw provides decision infrastructure to: • Intercept risky agent actions. • Enforce policy checks before execution. • Require human approval (HITL) for sensitive operations. • Record verifiable decision evidence to detect reasoning drift. --- ⚡ See DashClaw stop an agent from deleting production data Run DashClaw instantly with **one command**. What happens: • A local DashClaw demo runtime starts automatically. • A demo agent attempts a **high-risk production deploy**. • DashClaw intercepts the decision and **blocks the action before execution**. • Your browser opens directly to the **Decision Replay** showing the governance trail. No repo clone. No environment variables. No configuration. Just one command. --- What you’ll see • 🔴 High risk score (85) • 🛑 Policy requires approval before deploy • 🧠 Assumptions recorded by the agent • 📊 Full decision timeline with outcome --- Platform Overview **Mission Control** — Real-time strategic posture, decision timeline, and intervention feed. **Approval Queue** — Human-in-the-loop intervention with risk scores and one-click Allow / Deny. **Guard Policies** — Declarative rules that govern agent behavior before actions execute. **Drift Detection** — Statistical behavioral drift analysis with critical alerts when agents deviate from baselines. --- 🏗️ First Real Agent (5-Minute Integration) Ready to connect your own agent? Use the **OpenAI Governed Agent Starter** to see DashClaw in a real customer communication workflow. What it proves: • **Governance Before Execution**: checks policies *before* the action. • **Permissioned Autonomy**: Pausing for human approval (HITL) on high-risk actions. • **Verifiable Evidence**: Intent, assumptions, and outcomes recorded in your dashboard. View the Starter Source --- Quickstart • Install the SDK **Node.js:** **Python:** • Create the Client **Node.js:** **Python:** • Run Your First Governed Action The minimal governance loop wraps your agent's real-world actions: --- CLI Approval Channel Approve agent actions from the terminal without opening a browser. This is the primary interface for developers using Claude Code, Codex, Gemini CLI, or any terminal-first workflow. When an agent calls , the SDK prints a structured block to stdout showing the action ID, policy name, risk score, declared goal, and a replay link. Approve from any terminal and the agent unblocks instantly via SSE. The browser dashboard reflects the same decision within one second. Every governed action has a permanent replay URL: --- Local SDK Testing DashClaw includes a standalone Python integration test agent that exercises the major DashClaw SDK methods directly against a running instance. To run it locally: See the script comments for more flags and usage. --- Claude Code Hooks Govern Claude Code tool calls without any SDK instrumentation. Drop two Python scripts into and every Bash, Edit, Write, and MultiEdit call Claude makes is governed by your DashClaw policies. Merge the block from into your , then set three environment variables: The hooks require no pip installs and exit silently when DashClaw is unreachable. Claude Code is never blocked because your governance layer is down. See for the full installation guide and action type mapping. --- Deploy to Cloud (Self-Host) The fastest path to self-host DashClaw is via **Vercel + Neon**. • Fork this repo. • Deploy to Vercel and connect a free Neon Postgres database. • Run the interactive setup to configure secrets and run migrations: • Your instance is live. Grab your API key from the dashboard and point your first agent at it. --- Full SDK Documentation For the complete API surface, check out the SDK Reference. --- License MIT Built by Practical Systems