AGENTS.mdA

AGENTS.md from zhurong2020/pyobfus is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add zhurong2020/pyobfus/AGENTS.md@git:20261021.cc145b2

Pins git:20261021.cc145b2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
zhurong2020/pyobfus
Path
AGENTS.md
Versions recorded
14
Latest version
git:20261021.cc145b2, committed Oct 21, 2026
First version recorded
Sep 12, 2026
Size
12,353 bytes
Repository stars
11
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md — pyobfus

Canonical, tool-agnostic guide for AI coding agents (and humans) working **on**
the pyobfus codebase. Tool-specific files defer here: `CLAUDE.md` imports this
file; Cursor / Windsurf / Aider / Codex read `AGENTS.md` natively.

> Looking to *use* pyobfus to protect your own code, not develop it? See the
> [`pyobfus-review`](skills/pyobfus-review/SKILL.md) skill (read-only: should
> we obfuscate this, and what breaks?), the
> [`pyobfus-protect`](skills/pyobfus-protect/SKILL.md) skill (do it, and verify
> the result), and the [`templates/ai-integration/`](templates/ai-integration/)
> rule files instead.

## What this project is

pyobfus is an **AST-based Python code obfuscator** — framework-aware presets,
reverse stack-trace mapping for AI-assisted debugging, and a machine-readable
JSON CLI. A transparent, open-source alternative to PyArmor. The repo ships
**three Python distributions**:

- `pyobfus/` — the obfuscator (CLI + library). Published as `pyobfus`.
- `pyobfus_mcp/` — an MCP server exposing the tools to AI agents. Published as
  `pyobfus-mcp`.
- `pyobfus_runtime/` — the minimal redistributable runtime used by generated
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zhurong2020/pyobfus/AGENTS.md@sha256:4767d0709482c83c

The line at the top of this page pins the label git:20261021.cc145b2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_q72yydbwltzqappx.svg)](https://markdownregistry.com/a/art_q72yydbwltzqappx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 14 versions of this file, between Sep 12, 2026 and Oct 21, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20261021.cc145b2 latest2026-10-21 cc145b2 12,353 BA view · diff
git:20261021.d7dbc122026-10-21 d7dbc12 12,308 BA view · diff
git:20261021.a2859f72026-10-21 a2859f7 12,243 BA view · diff
git:20261020.95965652026-10-20 9596565 11,401 BA view · diff
git:20261020.baae6ee2026-10-20 baae6ee 11,363 BA view · diff
git:20261002.8b0245e2026-10-02 8b0245e 11,016 BA view · diff
git:20261002.4da6ad42026-10-02 4da6ad4 10,516 BA view · diff
git:20261002.1aac6ef2026-10-02 1aac6ef 9,670 BA view · diff
git:20260929.3f3804e2026-09-29 3f3804e 9,569 BA view · diff
git:20260923.00b1b7d2026-09-23 00b1b7d 9,199 BA view · diff
git:20260923.3263b3d2026-09-23 3263b3d 8,562 BA view · diff
git:20260922.259e8fe2026-09-22 259e8fe 8,487 BA view · diff
git:20260912.b0783372026-09-12 b078337 8,377 BA view · diff
git:20260912.58bea752026-09-12 58bea75 8,210 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (12353 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zhurong2020/pyobfus · 11 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_q72yydbwltzqappx
GET https://markdownregistry.com/api/v1/resolve?ref=zhurong2020/pyobfus/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4767d0709482c83c811fc5d9fea63c80dd42fdf81c1261a8f110e43f43a2b38f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from zhurong2020/pyobfus

CLAUDE.md CLAUDE.md file
zhurong2020/pyobfus · CLAUDE.md
git:20261021.316e752 · audit A · 11 stars
llms.txt@docs llms.txt file
zhurong2020/pyobfus · docs/llms.txt
git:20261020.baae6ee · audit A · 11 stars
llms-full.txt llms.txt file
zhurong2020/pyobfus · llms-full.txt
git:20261020.baae6ee · audit A · 11 stars
llms.txt llms.txt file
zhurong2020/pyobfus · llms.txt
git:20261020.baae6ee · audit A · 11 stars
pyobfus-protect SKILL.md skill
zhurong2020/pyobfus · skills/pyobfus-protect/SKILL.md · Obfuscate / protect Python source before shipping it, and verify the obfuscated output still runs. Use when the user…
git:20261012.07c5a0a · audit B · 11 stars
pyobfus-review SKILL.md skill
zhurong2020/pyobfus · skills/pyobfus-review/SKILL.md · Review a Python project for source-protection readiness without changing anything: what would break under obfuscation…
git:20260912.54b270c · audit B · 11 stars
.cursorrules Cursor rule
zhurong2020/pyobfus · templates/ai-integration/.cursorrules
git:20260611.bdfaad3 · audit A · 11 stars
AGENTS.md@templates/ai-integration AGENTS.md file
zhurong2020/pyobfus · templates/ai-integration/AGENTS.md
git:20261007.8f25d63 · audit A · 11 stars
CLAUDE.md@templates/ai-integration CLAUDE.md file
zhurong2020/pyobfus · templates/ai-integration/CLAUDE.md
git:20261007.8f25d63 · audit A · 11 stars

Every file in zhurong2020/pyobfus

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

Browse by kind, by grade A, or by owner.