pentestcode AGENTS.md

Repository instructions for PentestCode covering branch names, commit and pull-request titles, code style, package dependencies, and generated files. A branch is a separate line of development, while generated files are produced automatically from source definitions.

In plain words
What is it for?
Use them when creating a branch, writing commits or pull requests, changing the public protocol or server API, regenerating the JavaScript SDK, or checking which packages may depend on one another.
Why use it?
They keep changes consistent with the repository’s workflow and prevent developers from editing generated code or creating branches and commits that break project conventions.

Instructions file for CodexOpenCode

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/s0ld13rr/pentestcode/agents-md
Clone the repo
git clone --depth 1 https://github.com/s0ld13rr/pentestcode

Made for: Codex, OpenCode.

Per session 1,893 This file is loaded in full into every session.
When invoked 1,893 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 97% copy Near-identical to another mod 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.01893 $0.01893
Opus 5 $0.00946 $0.00946
Sonnet 5 $0.00379 $0.00379
Haiku 4.5 $0.00189 $0.00189

Measured yesterday against content hash 8cdccdef0192, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

pentestcode 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 yesterday.

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.

Origin

This is a copy

97% identical to opencode AGENTS.md — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

AGENTS.md · 162 lines

How it starts

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

  • To regenerate the legacy JavaScript SDK, run ./packages/sdk/js/script/build.ts.
  • After changing the public Protocol or Server HttpApi, run bun run generate from packages/client. Do not edit src/generated or src/generated-effect directly.
  • Keep runtime dependencies directed from Schema to Core and Protocol, then from Core and Protocol to Server. Client runtime code may depend on Schema and Protocol but never Core or Server; sdk-next composes Client, Core, and Server.
  • The default branch in this repo is dev.
  • Local main ref may not exist; use dev or origin/dev for diffs.

Branch Names

Use a short branch name of at most three words, separated by hyphens. Do not use slashes or type prefixes such as feat/ or fix/.

Examples: session-recovery, fix-scroll-state, regenerate-sdk.

Commits and PR Titles

Use conventional commit-style messages and PR titles: type(scope): summary.

Valid types are feat, fix, docs, chore, refactor, and test. Scopes are optional; use the affected package or area when helpful, e.g. core, opencode, tui, app, desktop, sdk, or plugin.

Examples: fix(tui): simplify thinking toggle styling, docs: update contributing guide, chore(sdk): regenerate types.

Style Guide

General Principles

  • Keep things in one function unless composable or reusable
  • Do not extract single-use helpers preemptively. Inline the logic at the call site unless the helper is reused, hides a genuinely complex boundary, or has a clear independent name that improves the caller.
  • Avoid try/catch where possible
  • Avoid using the any type
  • Use Bun APIs when possible, like Bun.file()
  • Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
  • Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
  • In src/config, follow the existing self-export pattern at the top of the file (for example export * as ConfigAgent from "./agent") when adding a new config module.
  • In Effect generators, bind services to named variables before calling methods. Do not use nested service yields such as yield* (yield* Foo.Service).bar().

Read the full file on GitHub · 162 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. yesterday First seen · 162 lines · 1,893 tokens per session scan A 8cdccdef0192

Subscribe to this mod's changes

pentestcode AGENTS.md is an instructions file published in the GitHub repository s0ld13rr/pentestcode (566 stars, last pushed 11d ago), licensed MIT. It adds 1,893 tokens to every session, about $0.0095 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to opencode AGENTS.md, differing in 2 lines, and is treated as a copy.

Related

Other instructions, from other repositories

E2B CLAUDE.md

Instructions for e2b-dev/E2B: Use pnpm for node and uv for python to install and update dependencies. Run pnpm run format, pnpm run lint and pnpm run typecheck before committing changes. When modifying the SDK packages, ensure equivalent changes are applied to both JS as well as sync and async Python implementations.…

e2b-dev/E2B · 306 tokens

AstrBot AGENTS.md

AGENTS.md instructions for AstrBotDevs/AstrBot, covering setup commands, core, dashboard(webui), pre-commit setup and dev environment tips.

AstrBotDevs/AstrBot · 1,511 tokens

AstrBot copilot-instructions.md

Copilot instructions for AstrBotDevs/AstrBot, covering astrbot development instructions, working effectively, bootstrap and install dependencies, running the application and dashboard build (vue.js/node.js).

AstrBotDevs/AstrBot · 736 tokens

dify AGENTS.md

AGENTS.md instructions for langgenius/dify, covering agents.md and repository gotchas.

langgenius/dify · 183 tokens

dify CLAUDE.md

Claude Code instructions for langgenius/dify, a project described as: Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.

langgenius/dify · 3 tokens

CodexPotter AGENTS.md

Instructions for breezewish/CodexPotter, covering repository guidelines, workflow principles, engineering rules, core principles: simplicity & readability and better maintainability.

breezewish/CodexPotter · 306 tokens