diff --git a/.gitignore b/.gitignore index b599ee6..802ce05 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,6 @@ __pycache__/ *.pyc .DS_Store *.tmp + +# transient browser-bridge capture artifacts +.playwright-cli/ diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..e4d69e7 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,289 @@ + + + + + +agent-ops — the operational layer for AI coding agents + + + + + + + + + + + + + +
+
+
Built & run by deemwar
+

Your AI coding agent needs
an operational layer.

+

+ A coding agent edits your source, runs your shell, reads whatever files it can reach, and + spends money — at machine speed, often unattended. That's a production system. These are + 33 small tools we built filling each operational gap, one real failure at a + time, running autonomous agent fleets on Claude Code in production. +

+ + +
+
33operational tools
+
0dependencies — stock python3 / bash
+
1script each — no install
+
heuristic& honestly labelled
+
+ +
+
Install — there is nothing to install
+
# clone once, run any tool directly:
+git clone https://github.com/deemwar-products/agent-ops
+python3 agent-ops/mcp-budget/mcp-budget .
+bash    agent-ops/preflight/preflight
+
+
+
+ +
+
+
+

The tools

+
Recover · prevent · observe · spend · secure · set up · verify. Each links to the write-up explaining the failure it prevents and the data behind it.
+
+ +
+

Recover & protect agent work

+

Get vanished work back, and make it impossible to lose in the first place.

+
+
recover

Get an agent's vanished commit back — reflog + fsck recovery for work you thought was gone.

+
unwedge

Rescue a Claude Code session stuck on the thinking-block 400 ("thinking blocks cannot be modified").

+
auto-snapshot

Make an agent's uncommitted work impossible to lose — auto-snapshot the working tree.

+
preflight

Ask git before your agents collide — a worktree/branch collision pre-check.

+
worktree-doctor

Flag agent worktrees that would silently lose work on cleanup.

+
mergerase

Find public capabilities that silently disappeared across a parallel-agent merge.

+
+
+ +
+

See your fleet (observe)

+

Observe what a dozen unattended sessions are actually doing.

+
+
fleet-ps

ps for your Claude Code agent fleet — which sessions are alive, on what branch, healthy or wedged.

+
session-stats

Read what a Claude Code session actually did, straight from the transcript.

+
review-brief

A reviewer brief from the transcript — close the AI-code verification gap.

+
+
+ +
+

Prevent & guard

+

Stop the destructive command, the hidden instruction, the runaway fan-out.

+
+
agent-guard

A PreToolUse hook that blocks destructive agent commands (git reset --hard, rm -rf, push --force).

+
agent-frisk

Find the invisible Unicode instructions that hijack a coding agent.

+
forkcap

A fork-budget guard that caps Claude Code's runaway nested subagents.

+
+
+ +
+

Secure & audit config

+

Measure blast radius and catch the lethal combination across grants.

+
+
agent-reach

Measure a coding agent's secret blast radius — which secret stores are in reach.

+
perm-audit

Flag over-permissive Claude Code settings.json permissions.

+
trifecta-scan

Cross-config lethal-trifecta scanner — catch read + untrusted + exfil reachable in one grant set.

+
mcp-audit

Lint your .mcp.json — the highest-trust, never-linted agent config — for egress/security surface.

+
+
+ +
+

Context & cost

+

Find the tokens you spend before the first prompt — and the ones wasted after.

+
+
mcp-budget

Measure the context tax of your MCP servers — tokens spent before your first prompt.

+
agent-waste

Audit a session transcript for wasted tokens — re-reads, redundant tool results.

+
context-carry

The cost of a read is its residence time — weight every result by tokens × turns re-sent.

+
cachecost

Prompt-caching economics — what caching is actually saving you.

+
context-lint

Audit your CLAUDE.md — it loads every session.

+
+
+ +
+

Config quality

+

Generate, lint, and de-drift the instruction files your agent reads every run.

+
+
claude-md-gen

Generate a correct starter CLAUDE.md from your repo.

+
skill-lint

Will your Claude Code skill ever get used? Lint its description.

+
agentdrift

Detect drift across a repo's agent-instruction files (CLAUDE.md / AGENTS.md / .cursorrules).

+
tooldoc

MCP tool-description quality audit — find the undocumented parameters your agent guesses.

+
+
+ +
+

Supply chain & ecosystem measurement

+

Run the measurement on your own repo before you trust the ecosystem's claims.

+
+
slopcheck

Audit dependencies for AI-hallucination / slopsquat risk.

+
mcpfunnel

Measure how much of the official MCP registry actually runs.

+
agentpr

Do AI PRs dodge review? Run the measurement on your own repo.

+
+
+ +
+

Author agent demos

+

Catch the render problems before you spend the render.

+
+
storyboard-doctor

Pre-render linter for auto-demo storyboard JSON — catch dead-air/duration mismatches before you render.

+
+
+ +
+

Lint every channel (output gates)

+

A human developer is gated everywhere — review reads the code, a teammate notices you're stuck, someone catches the key in the diff. An unattended agent has none of that. These are the cheap, loud, deterministic gates that put it back — one per channel the agent touches. Each exits non-zero on a problem, so it drops into a Stop hook or CI unchanged. agent-frisk guards the input channel; these four guard the output channels.

+
+
langcheck

Lint agent output prose for foreign-script intrusion, mojibake, and runaway repetition.

+
leaklint

Flag leaked secrets in agent output — redact-by-design, never reprints the value.

+
spinlint

Flag wasted-loop / stuck sessions burning tokens with no progress.

+
claimlint

Flag false completion claims ("tests pass", "created X") the transcript and filesystem contradict.

+
+
+
+
+ +
+
+
+

How it's built

+
Honest by construction — so you can trust the number on the screen.
+
+
+
One script, zero deps

Each tool is a single Python 3 or bash script. Stock interpreter only — nothing to pip install, nothing to vendor.

+
33 tools, green in CI

Every tool ships a self-contained suite that builds its own fixtures. CI runs all of them on every push and PR — one green check per tool.

+
Heuristic & honestly labelled

Estimates, not bills. Where a finding is uncertain — or our own hypothesis lost — the write-up says so.

+
From real failures

Each tool exists because something broke while running autonomous agent fleets in production. The write-up has the data behind it.

+
+
+
+ +
+
+
+

Putting agents to work on code that matters?

+

We run autonomous coding-agent fleets in production and build the operational layer that keeps them safe, observable, and cheap. If that's your problem too — let's talk.

+ Talk to us → +
+
+
+ + + + +