varmabudharaju

Agent Pd — Development skill for Claude Code

Development community

A police department for your Claude Code agents — a logging-only hook + CLI that audits the main agent and every subagent and reports rule offenses (permission bypass, out-of-scope & credential access.

How to install Agent Pd

This entry records only its repository, not the path inside it, so there is no exact command to give. Open varmabudharaju/agent-pd and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Pd does

A police department for your Claude Code agents — a logging-only hook + CLI that audits the main agent and every subagent and reports rule offenses (permission bypass, out-of-scope & credential access, self-permissioning, disallowed tools, redundant, off-task) with quoted evidence. Catch-and-report, never blocks.

Alternatives in Development

  • CORS — Scan an endpoint for CORS misconfiguration — arbitrary-origin reflection, null-origin trust, credential exposu 4.5k ★
  • Tentacle Planner — You are the Tentacle Planner — a meta-agent that analyzes this codebase and creates department tentacles to or 1.4k ★
  • Hermes Claude Auth — Claude Code OAuth bypass for hermes-agent 374 ★

README

agent-pd

A police department for your Claude Code agents

A logging-only hook records every tool & permission event from the main agent **and** its subagents; the `pd` CLI replays that log through six detectors and reports rule offenses with quoted evidence. **Catch-and-report — it never blocks.**

[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/varmabudharaju/agent-pd/blob/master/LICENSE) [![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-3776AB.svg?logo=python&logoColor=white)](https://github.com/varmabudharaju/agent-pd/blob/master/pyproject.toml) [![Tests](https://img.shields.io/badge/tests-474_passing-brightgreen.svg)](https://github.com/varmabudharaju/agent-pd/tree/master/docs/manual-tests/) [![Version](https://img.shields.io/badge/version-0.2.0-orange.svg)](https://github.com/varmabudharaju/agent-pd/blob/master/pyproject.toml) [![Runtime deps](https://img.shields.io/badge/runtime_deps-PyYAML_only-lightgrey.svg)](https://github.com/varmabudharaju/agent-pd/blob/master/pyproject.toml)

**[Quickstart](#quickstart)** · **[How it works](#how-it-works-mental-model)** · **[Detectors](#the-detectors)** · **[Architecture](https://github.com/varmabudharaju/agent-pd/blob/master/ARCHITECTURE.md)** · **[Security](https://github.com/varmabudharaju/agent-pd/blob/master/SECURITY.md)**

Caught on camera

The department's body-cam. agent-pd won't stop the heist — but every move your agents make ends up on the record.

![capture vs. read](https://raw.githubuserc