gitwtfhub

wtf is guardplane?

mkadri85/guardplane — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

Automatically reroute or pause an agent that is looping or overspending

REASON 3

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

REASON 4

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

What's in the stack?

TypeScriptNode.js

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.