AGENTS.mdA
AGENTS.md from bluechonk/modelmux is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add bluechonk/modelmux/AGENTS.md@git:20261107.bd0e3d9Pins git:20261107.bd0e3d9 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- bluechonk/modelmux
- Path
AGENTS.md- Versions recorded
- 10
- Latest version
- git:20261107.bd0e3d9, committed Nov 7, 2026
- First version recorded
- Oct 29, 2026
- Size
- 7,828 bytes
- Repository stars
- 11
- License
- MIT
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 —— modelmux
modelmux 是多渠道 LLM 网关：一个端口、动态模型池、渠道热插拔。项目介绍见 [README.md](README.md)，
架构与契约见 [docs/README.md](docs/README.md)。
## 通用规则
全局规则（环境 / 网络 / 临时文件 / 工作流 / 编码 / 文档 / 版本控制 / 平台）由全局真源
`~/.agents/AGENTS.md` 规定；各工具入口（`~/.zcode`、`~/.codex`、`~/.claude`、`~/.dsh`）都是它的软链。
本文件只写本仓库特有的约束，不复制全局规则。冲突优先级：用户当次明确指令 > 本文件 > 全局规则 > 技能默认行为。
## 仓库结构
```
packages/
cli/ 全局 mx 入口，esbuild 单文件 bundle
ui/ Web 控制台（Vite），不在 tsc solution 中
core/
gateway/ 共享层：runtime → pool/auth → http → app，单向分层，向上依赖失败
channels/ 渠道包：每个 <cid> 只实现 7 个文件（channel / cli / index + cred / upstream / catalog / billing）
```
- `packages/core/gateway` 不许出现渠道知识（厂商名、渠道特有字段、渠道模型名）。
- `packages/core/channels/<cid>` 超出 7 文件即违规。
- 共享层 `dependencies` 为空；渠道包只依赖 `@modelmux/gateway`。
- 落点由共享层按 `cid` 推导，渠道不许自己拼路径。
- 调用渠道模块前必须包 `runInChannel(cid, …)`（AsyncLocalStorage 上下文）。
- 分层由 `scripts/verify-layering.mjs` 强制，例外在 `ALLOWLIST` 声明理由。
完整契约见 [docs/CONTRACT-TS.md](docs/CONTRACT-TS.md)。
## 命令
```sh
npm install # npm workspaces
npm run build # tsc -b + esbuild cli + copy-ui
npm test # build + typecheck + 全部 verify:* + 全部包测试
npm run typecheck # 全工作区类型检查（含 UI）
…Read the whole file at its exact version.
How to install
mdr add bluechonk/modelmux/AGENTS.md@sha256:21605f2f0b9b04bfThe line at the top of this page pins the label git:20261107.bd0e3d9, 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.
[](https://markdownregistry.com/a/art_6ux2jwzu3cg4ribq)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 10 versions of this file, between Oct 29, 2026 and Nov 7, 2026, more than one a day. Its first recorded version is graded B and its latest A.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261107.bd0e3d9 latest | 2026-11-07 | bd0e3d9 | 7,828 B | A | view · diff |
| git:20261106.f07736d | 2026-11-06 | f07736d | 7,768 B | A | view · diff |
| git:20261106.003f685 | 2026-11-06 | 003f685 | 7,767 B | A | view · diff |
| git:20261105.38debea | 2026-11-05 | 38debea | 7,946 B | A | view · diff |
| git:20261105.29cf971 | 2026-11-05 | 29cf971 | 7,834 B | A | view · diff |
| git:20261102.d2bbb08 | 2026-11-02 | d2bbb08 | 7,092 B | A | view · diff |
| git:20261101.6ee502b | 2026-11-01 | 6ee502b | 6,961 B | A | view · diff |
| git:20261101.c4bb711 | 2026-11-01 | c4bb711 | 6,706 B | A | view · diff |
| git:20261029.b4eaf81 | 2026-10-29 | b4eaf81 | 36,279 B | B | view · diff |
| git:20261029.469f3de | 2026-10-29 | 469f3de | 35,952 B | B | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (7828 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
bluechonk/modelmux · 11 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6ux2jwzu3cg4ribq GET https://markdownregistry.com/api/v1/resolve?ref=bluechonk/modelmux/AGENTS.md GET https://markdownregistry.com/api/v1/blob/21605f2f0b9b04bf5e21d65133abeb4fcf724dbc6ba74066c956406474c4c4db
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 bluechonk/modelmux
Every file in bluechonk/modelmux