whatisgithub

What is guardplane?

mkadri85/guardplane — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A lightweight safety layer that watches AI agent fleets and can auto-fix, escalate, or kill agents that go wrong.

Mindmap

mindmap
  root((guardplane))
    What it does
      Records agent decisions
      Detects broken agents
      Auto fix or escalate
      Kill switch
    Tech stack
      TypeScript
      Zero dependencies
    Use cases
      Stop looping agents
      Catch cost runaways
      Escalate to human
    Audience
      AI agent builders
      Platform teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Wrap an existing AI agent so its actions are logged and reviewable

USE CASE 2

Automatically reroute or pause an agent that is looping or overspending

USE CASE 3

Escalate a quietly degrading agent to a human instead of letting it keep acting

USE CASE 4

Trip a kill switch to stop one agent or an entire fleet immediately

What is it built with?

TypeScriptNode.js

How does it compare?

mkadri85/guardplane0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Clone the repo, run npm install, then npm run demo to see it in action.

MIT license, use freely for any purpose including commercial use as long as you keep the copyright notice.

So what is it?

Guardplane is a small code library that acts as a safety layer for teams running fleets of AI agents, the kind of automated systems that can take real actions like calling tools, editing files, or making decisions on their own. The problem it addresses is that AI agents sometimes go wrong in production, and without something watching them, a broken agent can keep taking damaging actions before a human notices. The README points to a real example from April 2026 where a coding agent deleted a company's production database and its backups in about nine seconds. The library is not a full framework you build your whole system around. Instead it is a lightweight skeleton you wrap around whatever AI agent setup you already have. It works through a few connected pieces: a signal plane that records every decision an agent makes so it can be replayed later, a reasoning layer that runs simple checks to detect whether an agent is stuck in a loop, spending too much money, producing too many errors, or quietly getting worse, a confidence gate that decides whether a known problem can be fixed automatically or needs to be handed to a human, an action layer that can reroute an agent to a different model, roll it back, or pause it, and a kill switch that can stop one agent or the entire fleet immediately. A newer feature called the burn rate breaker watches for agents whose judgment is slowly degrading rather than failing all at once. It compares each agent's current failure rate to its own recent history, and if that rate climbs too fast, the agent is switched into a mode where it can still work but its output becomes a suggestion for a human to approve rather than an action it takes on its own. To try it out, you clone the repository, install its dependencies with npm, and run the included demo, which walks through a healthy agent, a looping agent, a cost overrun, and a quality decline, showing how each situation is handled. The project has zero runtime dependencies and is written in TypeScript, and it is offered as a companion piece to a blog post the author wrote called Who Operates the Operators.

Copy-paste prompts

Prompt 1
Help me wrap one of my AI agents with guardplane's controlPlane and observe calls
Prompt 2
Explain how guardplane's confidence gate decides between auto remediate and escalate to human
Prompt 3
Walk me through running the guardplane demo and what each simulated agent scenario shows
Prompt 4
Show me how to configure guardplane's burn rate breaker for an agent that is slowly degrading

Frequently asked questions

What is guardplane?

A lightweight safety layer that watches AI agent fleets and can auto-fix, escalate, or kill agents that go wrong.

What language is guardplane written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

What license does guardplane use?

MIT license, use freely for any purpose including commercial use as long as you keep the copyright notice.

How hard is guardplane to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is guardplane for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.