sbproxy AGENTS.md

A set of project instructions for developing and releasing sbproxy, a Rust workspace containing multiple related packages. It documents required checks, changelog handling, and how pushing code ships it.

In plain words
What is it for?
Use it when editing sbproxy, preparing commits, adding changelog fragments, running the project gate, or pushing a release.
Why use it?
It gives coding agents the repository rules and the exact checks needed before a change can pass CI, the automated build-and-test system.

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

Made for: Codex, OpenCode.

Per session 8,773 This file is loaded in full into every session.
When invoked 8,773 The same file — it is already loaded in full.
Security scan A 1 finding. 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.08773 $0.08773
Opus 5 $0.04387 $0.04387
Sonnet 5 $0.01755 $0.01755
Haiku 4.5 $0.00877 $0.00877

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

Security

Grade A, and why

sbproxy AGENTS.md scanned grade A with 1 finding 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

conformance/ - vendored curl-and-bash conformance suite
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 706 lines

How it starts

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

sbproxy (Rust workspace)

Last modified: 2026-08-20

The active implementation of sbproxy. Cargo workspace with ~20 crates under crates/, an e2e suite under e2e/, examples under examples/, and an internal observability/cache/AI/security stack.

Pre-commit checks

Before committing any change, run all checks. Each one corresponds to a required CI gate; if any fails locally, CI will fail too. The table is ordered the way scripts/check.sh runs them, cheapest first, so a failure that takes seconds to find is not discovered behind a ten-minute build.

Check Command
Tracker placeholders grep -rn 'WOR-XXX' crates/ --include='*.rs' --include='*.toml' (any hit fails)
pub-item ratchet bash scripts/check-pub-item-ratchet.sh
unwrap/expect/panic ratchet bash scripts/check-unwrap-ratchet.sh
AI dispatch stack budget bash scripts/check-stack-budget-ratchet.sh
Spec citations bash scripts/check-spec-citations.sh
Env mutation bash scripts/check-env-mutation.sh
NOTICE (Apache-2.0-only) bash scripts/check-notice.sh
Doc drift bash scripts/check-doc-drift.sh
Tapes + GIF wiring make tapes-check
Doc configs python3 scripts/sync-doc-configs.py --check
Documented output python3 scripts/check-doc-captures.py --check --stackless-only
Review-evidence parser python3 scripts/check-review-evidence.py --self-test
Changelog fragments python3 scripts/changelog-fragments.py --check
Installer sh scripts/tests/install_verify.sh
Format cargo fmt --all -- --check
Nested lockfiles bash scripts/check-nested-lockfiles.sh
Supply chain (crates) cargo deny --all-features check
Supply chain (npm) cd ui && npm audit --package-lock-only --audit-level=high
UI cd ui && npm ci && npm run typecheck && npm run test -- --run
Build cargo build --workspace --exclude sbproxy-e2e --locked
Test cargo nextest run --workspace --exclude sbproxy-e2e --locked --profile ci
Doctest cargo test --workspace --exclude sbproxy-e2e --locked --doc
Clippy cargo clippy --workspace --all-targets -- -D warnings
Docs RUSTDOCFLAGS="-D warnings -D missing_docs" cargo doc --workspace --no-deps --locked
Payment features (on by default) bash scripts/check.sh; SBPROXY_CHECK_PAYMENTS=0 skips it

Read the full file on GitHub · 706 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 · 706 lines · 8,773 tokens per session scan A ed47d0038206

Subscribe to this mod's changes

sbproxy AGENTS.md is an instructions file published in the GitHub repository soapbucket/sbproxy (51 stars, last pushed 2d ago), licensed Apache-2.0. It adds 8,773 tokens to every session, about $0.0439 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

deltallm AGENTS.md

Instructions for deltawi/deltallm, covering repository instructions, required first step and precedence and maintenance.

deltawi/deltallm · 229 tokens

higress AGENTS.md

AGENTS.md instructions for higress-group/higress, covering agents.md, mandatory issue-spec gate for agent-assisted changes, repository layout, plugins and plugins/wasm-go/ (primary wasm plugin framework, go).

higress-group/higress · 2,905 tokens

ai-gateway AGENTS.md

Instructions for ferro-labs/ai-gateway, covering agents.md, project overview, current development snapshot, public-facing wording and build, test, and run commands.

ferro-labs/ai-gateway · 20,242 tokens

litellm AGENTS.md

AGENTS.md instructions for BerriAI/litellm, a project described as: The fastest, litest AI Gateway. Rust core with Python SDK. Call 100+ LLM APIs in OpenAI (or native) format with cost tracking, guardrails, load balancing, and logging [Bedrock, Azure, OpenAI, Anthropic, OpenAI, VertexAI, vLLM, Nvidia NIM].

BerriAI/litellm · 10 tokens

litellm GEMINI.md

Gemini CLI instructions for BerriAI/litellm, a project described as: The fastest, litest AI Gateway. Rust core with Python SDK. Call 100+ LLM APIs in OpenAI (or native) format with cost tracking, guardrails, load balancing, and logging [Bedrock, Azure, OpenAI, Anthropic, OpenAI, VertexAI, vLLM, Nvidia NIM].

BerriAI/litellm · 10 tokens

tiygate AGENTS.md

Instructions for tiylabs/tiygate, covering repository guidelines, project structure & module organization, engineering principles, build, test, and development commands and coding style & naming conventions.

tiylabs/tiygate · 1,187 tokens