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.
npx agentmods add instructions/mustafagoksever/java-inspector/agents-mdgit clone --depth 1 https://github.com/mustafagoksever/java-inspectorWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.03405 | $0.03405 |
| Opus 5 | $0.01702 | $0.01702 |
| Sonnet 5 | $0.00681 | $0.00681 |
| Haiku 4.5 | $0.00341 | $0.00341 |
Grade A, and why
java-inspector AGENTS.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.
How it starts
The opening of the file, as written. The whole thing — 233 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Agent Instructions — java-inspector
What this is
TypeScript MCP server that decompiles Java classes from Maven dependencies using Vineflower. Ships as an npm package with a bundled Vineflower JAR.
Developer commands
| Task | Command |
|---|---|
Build (compile src/ → dist/) |
npm run build |
| Run dev (no build step) | npm run dev (uses tsx) |
| Start built server | npm start |
| Test | npm test (Jest, currently no test files exist) |
| Publish prep | npm run prepublishOnly (runs tsc) |
Runtime requirements
- Node.js ≥ 16
- Java runtime (for Vineflower decompiler and
javap) - Maven (for
dependency:build-classpathscanning)
Architecture & entry points
| File | Role |
|---|---|
src/index.ts |
MCP server (JavaClassAnalyzerMCPServer). Exposes 5 tools: scan_dependencies, decompile_class, analyze_class, search_class, get_inheritance_tree |
src/cli.ts |
Commander CLI. Default action (no args) starts the MCP server |
src/cache/ProjectCache.ts |
Cache I/O: JSONL append-only persistence, in-memory Map index, pom/classpath hash validation, cross-process file locking via proper-lockfile |
src/scanner/DependencyScanner.ts |
Runs mvn dependency:build-classpath, parses JAR paths. Singleton. Integrates BackgroundScanner + LazyResolver |
src/scanner/BackgroundScanner.ts |
Background batch parallel JAR scanning (20 JARs at a time). Writes to JSONL incrementally |
src/scanner/LazyResolver.ts |
On-demand class resolution: O(1) memory lookup, parallel JAR search on cache miss |
src/decompiler/DecompilerService.ts |
Extracts .class from JARs (via yauzl), runs Vineflower (java -jar vineflower.jar <class> <outdir>). Reads generated .java from output dir and cleans up temp files |
src/analyzer/JavaClassAnalyzer.ts |
Runs javap -v -cp <jar> <class> and parses the text output |
src/utils/methodExtractor.ts |
Extracts a single method body from decompiled source via regex + brace matching. Handles strings, line/block comments, nested braces, and abstract methods. |
src/utils/cachePaths.ts |
Cache lives under ~/.cache/java-inspector/<project>_<hash>/ |
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.
- 2d ago First seen · 233 lines · 3,405 tokens per session scan A 5362ceb37241
java-inspector AGENTS.md is an instructions file published in the GitHub repository mustafagoksever/java-inspector (1 stars, last pushed 11d ago), licensed Apache-2.0. It adds 3,405 tokens to every session, about $0.0170 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-31.
Other instructions, from other repositories
parallel-code CLAUDE.md
Instructions for johannesjo/parallel-code, covering parallel code, stack, commands, project structure and conventions.
cezar AGENTS.md
Instructions for open-mercato/cezar, covering agents.md — working in this repository, zero config, changing a mechanism that already works, the http api and repository layout.
many-ai-cli CLAUDE.md
Instructions for ishizakahiroshi/many-ai-cli, covering many-ai-cli 開発ガイド, プロジェクト概要, 新規 provider を増やす提案をしない（2026-08-13 制定）, デスクトップアプリ化・microsoft store 提出は提案しない（2026-08-14 制定） and 現在の実装状態.
seamless AGENTS.md
Instructions for 0spoon/seamless, covering agents.md, go style rules, general, package structure and naming.
seamless CLAUDE.md
Instructions for 0spoon/seamless, covering claude.md, what is seamless?, project structure, common commands and single test.
agentx AGENTS.md
Instructions for sageox/agentx, covering agent instructions, quick reference, releases, code quality and landing the plane (session completion).