What is pypi AGENTS.md?

Repository instructions for ResQ’s Python packages, including a fleet API, an agent-integration server, and data-structure libraries published through PyPI, Python’s package registry.

Use them when changing these packages, running their checks, preparing releases, or deciding which package and command a change belongs to.

They centralize the repository map, supported Python and build tools, release rules, and commands for testing, linting, and type checking.

pypi AGENTS.md — Instructions file for Codex and OpenCode by resq-software: Repository instructions for ResQ’s Python packages, including a

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/resq-software/pypi/agents-md

Clone the repo

git clone --depth 1 https://github.com/resq-software/pypi

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/resq-software/pypi/agents-md.svg)](https://agentmods.dev/instructions/resq-software/pypi/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/resq-software/pypi/agents-md"><img src="https://agentmods.dev/badge/instructions/resq-software/pypi/agents-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 706 This file is loaded in full into every session.

When invoked 706 The same file — it is already loaded in full.

Security scan C 2 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.

Model	Per session	Once invoked
Fable 5	$0.00706	$0.00706
Opus 5	$0.00353	$0.00353
Sonnet 5	$0.00141	$0.00141
Haiku 4.5	$0.00071	$0.00071

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

Security

Grade C, and why

pypi AGENTS.md scanned grade C with 2 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 3d 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.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-hooks.sh | sh

Makes network callslowCapability

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

curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-hooks.sh | sh

AGENTS.md · 71 lines

How it starts

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

ResQ PyPI Packages — Agent Guide

Mission

Registry workspace for ResQ Python packages published to PyPI.

Stack

Runtime: Python 3.11+
Build: Hatchling
Package Manager: uv
Testing: pytest (+ hypothesis for property-based tests in resq-mcp)
Linting: ruff + mypy (strict)
Release: python-semantic-release for both published packages. Triggered manually via workflow_dispatch — the branch ruleset rejects the release commit, so pushes do not publish.

Repo Map

packages/resq-mcp/ — FastMCP server for AI agent integration (drone fleet, PDIE, DTSOP)
packages/resq-dsa/ — Zero-dependency data structures & algorithms (Bloom, CountMin, Graph, Heap, Trie, Rabin-Karp)
packages/fleet-api/ — FastAPI service for fleet state and sector deployments. Not published; no release lane.

Commands

# resq-mcp
cd packages/resq-mcp && uv sync && uv run pytest
uv run ruff check src/ tests/
uv run mypy src/

# resq-dsa
cd packages/resq-dsa && uv sync && uv run pytest
uv run ruff check src/ tests/

# fleet-api
cd packages/fleet-api && uv sync && uv run pytest
uv run ruff check src/ tests/

Rules

resq-dsa must have zero runtime dependencies — stdlib only
Each package has its own pyproject.toml and virtual environment
Python 3.11+ minimum across all packages
ruff for linting, mypy for type checking (strict mode)
All source files must include Apache-2.0 license header
AGENTS.md is the source of truth for CLAUDE.md — never edit CLAUDE.md directly

Safety

Don't add runtime dependencies to resq-dsa
Don't publish without running full test suite and linting
resq-mcp safe mode (RESQ_SAFE_MODE=true) is default — mutations raise errors

Workflow

cd into the specific package directory
uv sync to install dependencies
uv run pytest to test
uv run ruff check src/ tests/ to lint
Summarize: files changed, behavior change, tests run

References

resq-mcp README — Full MCP server documentation
resq-dsa README — DSA library documentation
README — Package overview

Read the full file on GitHub · 71 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.

3d ago First seen · 71 lines · 706 tokens per session scan C 9eb61bc03ca9

Subscribe to this mod's changes

pypi AGENTS.md is an instructions file published in the GitHub repository resq-software/pypi (1 stars, last pushed 3d ago), licensed Apache-2.0. It adds 706 tokens to every session, about $0.0035 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Languages Python ai-agents digital-twin drone-coordination fastmcp incident-response mcp-server

microsoft-planner-mcp python.instructions.md

Use when writing or modifying Python source code. Covers module layout, async patterns, imports, and framework conventions for FastMCP + Microsoft Graph SDK.

aixolotl/microsoft-planner-mcp · 1,100 tokens

appkit-bpmn-server python.instructions.md

Python development guidelines and best practices for the appkit project.

jenreh/appkit-bpmn-server · 1,740 tokens

ros2_mcp AGENTS.md

AGENTS.md instructions for wise-vision/ros2_mcp, covering agent instructions, project layout, dev setup (preferred), running locally and tests.

wise-vision/ros2_mcp · 665 tokens

nextcloud-mcp-server CLAUDE.md

Claude Code instructions for cbcoutinho/nextcloud-mcp-server, covering claude.md, coding conventions, async/await patterns, type hints and code quality.

cbcoutinho/nextcloud-mcp-server · 8,223 tokens

mcp-zen-of-languages mandatory-python-312.instructions.md

Instructions for Anselmoo/mcp-zen-of-languages, covering python 3.12+ syntax updates summary, changes made, ✅ updated files, syntax changes and before (python 3.9 style).

Anselmoo/mcp-zen-of-languages · 1,229 tokens

naja-scope CLAUDE.md

Instructions for najaeda/naja-scope: When writing code that talks to najaeda — inside src/najascope/ or in throwaway exploration scripts — always go through from najaeda import naja (the raw naja.so binding: NLUniverse, NLDB, SNL objects) and never through najaeda.netlist (the high-level loadverilog/loadsystemverilog/…

najaeda/naja-scope · 397 tokens

pypi AGENTS.md