[bmdpat]
§ 001 / AGENTGUARD

Runtime guardrails for
AI agents_

I'm Patrick Hughes. I build small AI tools for developers shipping agents into the real world. AgentGuard is the flagship: budget caps, loop detection, timeouts, and kill switches before your agent burns money at 2 AM.

install
$ pip install agentguard47
PyPI downloads
5,000+
GitHub stars
3
Package
Python
Built by
1 developer

Observed package downloads, updated hourly. SDK lifetime counts use Pepy; SDK recent-month counts use Pypistats; MCP recent-month counts use npm. Downloads are a usage signal, not an adoption proof. Tracked copy is shown when a metric upstream is unavailable.

The bet: a useful software company can be one human, a stack of tools, and agents doing the boring work.

§ 002 / WHY IT EXISTS

First stop the run. Then inspect it.

Most agent tools tell you what happened after the run. AgentGuard is the guardrail layer I wanted before letting agents work unattended.

Start with the Python SDK. Add MCP only when you want your coding agent to read traces and budget health. Use the hosted dashboard when local files are not enough.

Read GitHub docs ->
Downloads
5,000+
Version
v1.2.13
GitHub stars
3
Forks
2

Observed package downloads, updated hourly. SDK lifetime counts use Pepy; SDK recent-month counts use Pypistats; MCP recent-month counts use npm. Downloads are a usage signal, not an adoption proof. Tracked copy is shown when a metric upstream is unavailable.

local proof in code
from agentguard import BudgetGuard, JsonlFileSink, LoopGuard, Tracer

budget = BudgetGuard(max_cost_usd=5.00, max_calls=50)
loop = LoopGuard(max_repeats=3)
tracer = Tracer(
    sink=JsonlFileSink(".agentguard/traces.jsonl"),
    service="support-agent",
    guards=[loop],
)

with tracer.trace("agent.run") as span:
    budget.consume(calls=1, cost_usd=0.02)
    loop.check("search", {"query": "refund policy"})
    span.event("tool.call", data={"tool": "search"})
    # Call your agent or tool here.
If the run crosses a limit, AgentGuard raises clearly and writes local proof you can inspect without a dashboard.

Use the right layer

SDK

Stop bad runs in Python.

Open source. Local-first. Raises inside the running process when a budget, loop, rate, retry, or timeout limit is crossed.

MCP

Let coding agents inspect proof.

Read-only access for Claude Code, Cursor, Codex, and other MCP clients to traces, alerts, usage, costs, and budget health.

Dashboard

Keep retained runs when local files are not enough.

Use the hosted app for read keys, retained history, alerts, and shared visibility. Keep the first integration local if that is all you need.

Create read key ->

What it stops

Budget caps

Stop a run before an experiment turns into a surprise bill.

Loop detection

Kill repeated tool calls before retries become an operator problem.

Timeouts

Put a hard wall-clock ceiling around unattended agent work.

Rate limits

Keep background jobs from hammering tools while nobody is watching.

Retry limits

Stop retry storms instead of letting flaky tools spin forever.

Local proof

Write JSONL traces and incident reports without sending data anywhere.

Optional MCP config

MCP client config
{
  "mcpServers": {
    "agentguard": {
      "command": "npx",
      "args": ["-y", "@agentguard47/mcp-server"],
      "env": {
        "AGENTGUARD_API_KEY": "ag_your_read_key_here"
      }
    }
  }
}
§ 003 / TOOLS

AgentGuard is the flagship. 11 more live tools make up the shelf.

Use AgentGuard when you need runtime controls. Current shelf: 12 live from 12 public tools. Open what helps. Skip what does not.

01 / free / Python* LIVE
AgentGuardv1.2.13

Runtime guardrails for Python agents: budget, loop, timeout, and rate limits with MCP visibility for Claude Code, Cursor, and Codex.

$ pip install agentguard47
02 / free+pro / browser* LIVE
VRAM Calculatorweb

Estimate GGUF VRAM fit, --n-gpu-layers 53 planning, and CPU offload risk from model, quant, GPU, and context presets.

03 / free+pro / browser* LIVE
Model Pickerweb

Rank 18 local models across 6 workloads and 3 priorities for GPU fit.

04 / free+pro / browser* LIVE
Quantization Compareweb

Compare 9 GGUF quant levels by size, quality, speed, and 24GB GPU fit.

05 / $7/mo* LIVE
Local LLM Toolkit Pro7-day trial

Remove the 5 free runs per tool per day limit. Saved GPU rigs, Hugging Face model import, fit alerts, and benchmark history for local LLM builders.

06 / free / browser* LIVE
Agent Roadmap Scannerweb

Describe an AI agent workflow. Get risk score, top risks, architecture, first guardrails, and next steps.

07 / free / Cursor* LIVE
Agent Architectweb

Agent Architect scopes AI agent builds into DIY / Startup / Growth / Enterprise tiers with top 3 risks, cost, timeline, and architecture output.

08 / free / browser* LIVE
AgentFlowweb

Watch two AI agents coordinate through 5 pipeline steps, 1 tool call, and 1 handoff.

09 / free / browser* LIVE
MarkUpweb

Paste a URL. Get summary, topics, sentiment, and entities plus saved history.

10 / free / browser* LIVE
Sidecastweb

4 AI personas reacting to your live podcast in real time.

11 / paid / API* LIVE
Agent Memory APIx402

Pay-per-call memory for agents. USDC on Base, no accounts.

12 / free / browser* LIVE
Dota 2 Statsweb

Look up public Dota 2 profiles, recent matches, ranks, hero performance, and 10-player breakdowns via OpenDota.

§ 004 / BUILDER

Built by one developer using the product.

This is not a platform committee. It is Patrick building useful AI tools, using AgentGuard on the agent work that should not run loose.

01

Runtime controls

AgentGuard is the product I reach for before an agent can run past budget, loop, timeout, and rate limits.

02

Agent fleet

22 small agents handle repeatable work: checks, summaries, drafts, and repo chores.

03

Build notes

Every useful lesson turns into docs, posts, examples, or another small tool.

04

One operator

Patrick keeps the judgment. The software handles the boring loops around it.

§ 004 / BUILD NOTES[ ALL POSTS ] ->

Recent notes from the build.

Short posts on agents, local models, cost control, and the parts of this stack that actually held up.

§ 005 / NEWSLETTER

Get the build notes.

What shipped, what broke, and what I learned while building a one-person AI tools company. Monday through Friday when there is something useful to send. Unsubscribe in one click.

$

Get The One-Person Holdco (free PDF)

How one human plus twenty-two AI agents runs a seven-pillar portfolio with no employees.