Skip to content

Latest commit

Β 

History

479 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Intutic β€” Policy as Code for Continuous Compliance & Continuous Enforcement for AI Agents

The circuit breaker for AI agents: your policies are files in git, enforced synchronously and in-process on every tool call across 42 agent harnesses.

GitHub Stars License: MIT Documentation Build Status PRs Welcome

Quickstart β€’ Architecture β€’ Key Features β€’ Supported Harnesses β€’ Docs


Intutic Hero Demo β€” Real-time AI Agent Circuit Breaker

πŸ’‘ Why Intutic?

Existing AI observability tools (like LangSmith or Portkey) are passive. They record execution logs after an agent leaks a secret, deletes files, or loops into hundreds of dollars of API spend.

Intutic is an active circuit breaker. It sits in the tool-call path between your AI agents and local shell/production APIs. Every tool execution passes through an in-process policy evaluation chain β€” no model call, no network hop β€” blocking dangerous commands before they run and steering agentic loops in real time.


πŸ—οΈ Architecture

Intutic runs as a high-performance local or self-hosted proxy (written in Rust) alongside a lightweight bidirectional config sync daemon (sync-daemon):

flowchart TD
    subgraph DevEnvironment[" πŸ’» Developer Environment "]
        Agent["πŸ€– AI Coding Agent<br><i>(Claude Code, Cursor, Aider, LangGraph)</i>"]
        SOP["πŸ“ Local SOP Rules<br><i>(CLAUDE.md / .cursorrules / SKILL.md)</i>"]
    end

    subgraph HotPathProxy[" ⚑ Intutic Hot-Path Proxy (:4000) "]
        Engine["πŸ”’ WASM Policy Engine<br><i>(In-Process Evaluation)</i>"]
        DLP["πŸ” Secret DLP & Masking"]
        PCAS["πŸ›‘οΈ PCAS Action Primitives<br><code>BYPASS</code> | <code>ENHANCE</code> | <code>HIJACK</code> | <code>REASK</code> | <code>KILL</code>"]
    end

    subgraph SyncDaemon[" πŸ”„ Sync Daemon "]
        Reconcile["Bidirectional Config Reconciler<br><i>(Harness Config Sync)</i>"]
    end

    subgraph UpstreamProviders[" 🌐 Upstream Providers "]
        Providers["Anthropic API / OpenAI / LiteLLM / Ollama"]
    end

    Agent -->|1. Tool Call / Prompt| HotPathProxy
    SOP -->|2. Rule Sync| Reconcile
    Reconcile -->|3. Hot-Reload Rules| Engine
    HotPathProxy -->|4. Clean Request| UpstreamProviders
    Engine -->|5. Block/Hijack Verdict| Agent
Loading

⚑ 30-Second Quickstart

1. Install the CLI & Native Proxy Gateway

# Install global CLI and native Rust proxy binary
npm install -g @intutic/cli @intutic/proxy

# Or run the native proxy directly on-demand
npx @intutic/proxy

2. Connect Your Workspace

Run intutic connect inside your project folder. This boots the local high-speed Rust proxy on port 4000 and auto-detects installed coding assistants:

intutic connect

3. Route Any Agent to Intutic

Point your favorite LLM client or agent framework to the local proxy:

export ANTHROPIC_BASE_URL="http://localhost:4000/v1"
export OPENAI_BASE_URL="http://localhost:4000/v1"

That's it! Your agent is now governed by real-time safety guardrails.


πŸ”₯ Key Features

Feature Description
⚑ In-Process WASM Engine Policy evaluation runs in-process β€” no model call and no network hop β€” so it adds no round-trip to the tool-call path.
πŸ›‘οΈ Zero-Trust Tool Interception Intercepts dangerous commands before they touch your system: rm -rf and git push --force are blocked at the harness hook gate; a DROP TABLE in an MCP tool call is blocked by the MCP governance proxy, and at the hook gate it is flagged for triage rather than blocked (the LLM proxy itself has no SQL rule).
πŸ” Secret DLP & Masking Automatically redacts API keys ([REDACTED_SECRET]), AWS credentials, and tokens in prompts & tool payloads.
πŸ’° Session Spend Ceilings Prevents "loop burn" by enforcing token spending ceilings per session (e.g. $5.00 limit).
πŸ”„ 42 Harness Adapters Pre-configured support for Claude Code CLI, Cursor, Windsurf, Aider, Antigravity, OpenCode, DeepSeek dsh, Spotify Xirp, DoorDash Agentic Orchestrator, AWS Bedrock AgentCore Runtime, and more.
πŸ€– Single & Multi-Agent Swarms Governs single developer tools as well as multi-agent graph/swarm workflows β€” LangGraph, LangChain, CrewAI, AutoGen, AG2, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, and AWS Strands Agents each have a dedicated SDK-side gate (Python); Mastra, the Vercel AI SDK, and TrueForge (embedded) have the same on the TypeScript side (@intutic/gate).

πŸ›‘οΈ The 5 PCAS Primitives

Every tool call and prompt evaluated by Intutic produces one of five PCAS Action Primitives:

 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
 β”‚  BYPASS  β”‚  β”‚  ENHANCE  β”‚  β”‚   HIJACK   β”‚  β”‚  REASK   β”‚  β”‚   KILL   β”‚
 β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
      β”‚              β”‚              β”‚              β”‚              β”‚
      β–Ό              β–Ό              β–Ό              β–Ό              β–Ό
 Direct Pass    Inject Safety  Redact Secrets    Refuse &      Hard-Abort
 (In-Process)    Context SOP    or Swap Args    Bounded Retry  Runaway Loop
  1. BYPASS: Standard safe execution passes through natively (in-process, no added network hop).
  2. ENHANCE: Inject contextual SOP prompt rules or architectural guidelines.
  3. HIJACK: Substitute dangerous tool parameters or redact secrets on the fly.
  4. REASK: Refuse the attempt and hand the reason back to the agent, which may retry a bounded number of times before the finding escalates to a block.
  5. KILL: Hard-abort execution thread if an agent attempts destructive file/git ops or hits loop caps.

πŸ”Œ Supported Harnesses & Frameworks

Intutic ships 42 harness adapters that are auto-detected and config-synced without modifying your agent's source code, and every one of them is a supported harness β€” no adapter carries an open support gap today (AutoGen's closed with its workbench gate, the Agentic Orchestrator's with OpenCode's own adapter, both in September 2026). Anything else that speaks an OpenAI- or Anthropic-compatible API is governed the same way by pointing its base URL at the proxy:

Category Supported Tools & Frameworks
Single-Agent Assistants (native adapters) Claude Code CLI, Cursor, Windsurf, Aider, Antigravity, Cline, Roo Code, Codex, Continue, Claude Desktop, Goose, Pi, GitHub Copilot, OpenWebUI, Muse Code, Grok Build, OpenCode, dsh (preview)
Multi-Agent Swarms (native adapters) LangGraph, OpenHands, OpenClaw, Hermes, n8n
Orchestrators (delegate to already-gated harnesses, no gate of their own) Spotify Xirp, DoorDash Agentic Orchestrator, AWS Bedrock AgentCore Runtime (hosts your own framework-SDK code unchanged; delegates to whichever already-supported framework adapter that code uses)
SDK-gated frameworks (dedicated in-process gate, @intutic/gate/intutic-clawde) LangChain, CrewAI, AutoGen, AG2, Google ADK, OpenAI Agents SDK, Pydantic AI, smolagents, AWS Strands Agents, Mastra, Vercel AI SDK, eve, TrueForge (embedded), AI SDK Harness, AI SDK Workflow
Bridge-gated (out-of-process Intutic-operated service, no gate in the harness's own process) TrueForge (standalone/hosted server β€” services/trueforge-bridge)
Any OpenAI-compatible framework (no adapter needed) Anything else honoring OPENAI_BASE_URL / ANTHROPIC_BASE_URL β€” launch it with intutic exec or export the base-URL env vars
Server-side platform integrations (call Intutic directly over HTTP; no HarnessType, not auto-detected by intutic init) QM (securityScreen HTTP contract), Anthropic Managed Agents (session-confirmation responder), AWS Bedrock AgentCore Gateway (interceptor Lambda)

πŸ“ Write Your First SOP

Intutic governance rules are written in standard Markdown files inside your repository root (CLAUDE.md, .cursorrules, or .windsurfrules). Intutic automatically syncs and enforces them in real time:

# Standard Operating Procedure (SOP): Safety Guardrails

## Rules
1. **No Secret Leaks**: Agents must never output raw API keys or passwords.
2. **File Boundaries**: Restrict file modifications to the current project directory.
3. **No Force Push**: Block `git push --force` on all branches.

## Denied Commands
- `rm -rf`
- `DROP TABLE`
- `TRUNCATE`

πŸ’¬ Interactive Slash Commands

Because Intutic evaluates prompts pre-flight, you can run interactive governance commands directly inside your agent chat:

/intutic status   # View active session spend and compliance score
/intutic rules    # List active WASM & Markdown SOP rules

πŸ“š Documentation & Community


⭐ Star Us On GitHub

If you find Intutic useful, please give us a star on GitHub! It helps us support more agent harnesses and policy engines.

Star on GitHub


🏒 Enterprise & Commercial Licensing

For custom VPC deployments, enterprise-grade SSO/SAML, dedicated SLA support, or team compliance auditing, visit intutic.ai or contact us at support@intutic.ai.


πŸ“„ License

This project is licensed under the MIT License.

About

The open source circuit breaker for AI agents. Real-time security, secret DLP, graph guardrails and loop burn prevention for Claude Code, Cursor, Antigravity, LangGraph, n8n and many more.

Topics

Resources

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages