grroxy CLAUDE.md

A set of Claude Code instructions for Grroxy, a cybersecurity proxy toolkit that lets developers inspect and modify web traffic and use AI-assisted security analysis.

In plain words
What is it for?
It helps with work on Grroxy's Go backend, Svelte interface, Electron desktop app, command-line tools, HTTP proxy, browser automation, and MCP endpoint.
Why use it?
It gives an agent the project's technology choices, layout, binaries, and architecture so it can make changes in the right places.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/glitchedgitz/grroxy/claude-md
Clone the repo
git clone --depth 1 https://github.com/glitchedgitz/grroxy
Per session 2,932 This file is loaded in full into every session.
When invoked 2,932 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02932 $0.02932
Opus 5 $0.01466 $0.01466
Sonnet 5 $0.00586 $0.00586
Haiku 4.5 $0.00293 $0.00293

Measured 2d ago against content hash fea5af90fda5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

grroxy CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 256 lines

How it starts

The opening of the file, as written. The whole thing — 256 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Grroxy

Cybersecurity proxy toolkit that blends manual web testing with AI agents. Intercepts HTTP/HTTPS traffic, provides request modification, fuzzing, browser automation, and an MCP endpoint for AI-driven security analysis. Built as a multi-binary Go backend with a Svelte frontend.

Version: 2026.4.2 (App) / 0.29.1 (Backend & Frontend)

Tech Stack

  • Backend: Go 1.24 (toolchain go1.24.1)
  • Database: PocketBase (forked: github.com/glitchedgitz/pocketbase)
  • Frontend: Svelte 5 + Vite + Tailwind CSS + SvelteKit (dev UI)
  • Desktop: Electron 36.4.0
  • CLI: cobra (command framework)
  • HTTP: echo/v5 (web framework), custom raw HTTP parser, uTLS
  • Browser: chromedp (Chrome DevTools Protocol)
  • Key libs: cook/v2 (payload generation), dadql (query language), wappalyzergo (tech detection), mcp-go (Model Context Protocol), fsnotify (file watching)

Architecture

Binaries

Binary Entry Point Purpose
grroxy cmd/grroxy/main.go Launcher - manages projects, starts per-project backends, global templates
grroxy-app cmd/grroxy-app/main.go Project backend - proxy, intercept, templates, all per-project APIs
grroxy-tool cmd/grroxy-tool/ Standalone tools server (fuzzer, SDK)
grx-fuzzer cmd/grx-fuzzer/main.go Standalone HTTP/HTTP2 fuzzer CLI
grxp cmd/grxp/main.go URL parser/prober from stdin with dadql filtering

Directory Layout

apps/
  app/           # grroxy-app backend logic (~40 files: proxy, intercept, templates, MCP, etc.)
  launcher/      # grroxy launcher backend (project management, template distribution)
  tools/         # grroxy-tool backend (fuzzer)
cmd/
  grroxy/        # Main CLI entry + migrations
  grroxy-app/    # Project app entry + migrations
  grroxy-tool/   # Tool server entry + migrations
  electron/      # Electron desktop wrapper
  grx-fuzzer/    # Fuzzer CLI
  grxp/          # URL parser CLI
grx/
  browser/       # Chrome automation (chromedp wrappers)
  dev/           # Developer UI (SvelteKit, served at /dev)
  frontend/      # Main production frontend (Svelte, bundled into binary)
  fuzzer/        # Fuzzing engine (cluster bomb, pitch fork modes)
  rawhttp/       # Raw HTTP/1.1 & HTTP/2 parser and client
  rawproxy/      # MITM proxy with TLS, cert generation, WebSocket support
  templates/     # Template engine with hooks and default configs
  version/       # Version constants
internal/
  config/        # Config struct and initialization
  logflags/      # Log flag setup
  process/       # Process/command management
  save/          # File saving utilities
  schemas/       # PocketBase collection schemas (22 files)
  sdk/           # Client SDK
  types/         # Shared type definitions
  updater/       # Binary self-updater (GitHub Releases)
  utils/         # Utility functions

Read the full file on GitHub · 256 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 256 lines · 2,932 tokens per session scan A fea5af90fda5

Subscribe to this mod's changes

grroxy CLAUDE.md is an instructions file published in the GitHub repository glitchedgitz/grroxy (138 stars, last pushed 17d ago), licensed MIT. It adds 2,932 tokens to every session, about $0.0147 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.