AGENTS.md@packages/core/channels/catpawA

AGENTS.md@packages/core/channels/catpaw from bluechonk/modelmux is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add bluechonk/modelmux/packages/core/channels/catpaw/AGENTS.md@git:20261019.f7f08e1

Pins git:20261019.f7f08e1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
bluechonk/modelmux
Path
packages/core/channels/catpaw/AGENTS.md
Versions recorded
4
Latest version
git:20261019.f7f08e1, committed Oct 19, 2026
First version recorded
Oct 17, 2026
Size
2,023 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

本仓库是 **本地网关 + 逆向研究** 项目:不提供任何对外运行时能力,只服务本机、本账号。
当前实现为 **TypeScript**(Node ≥ 22.6),是 `modelmux` 工作区的一个渠道包。

## 不可协商的约束

- **凭据零入库、零回显**:不得把任何真实 token / 机器码 / 密钥写进代码、文档、
  日志或 commit。对外输出只允许脱敏形态(`前缀…[长度]`)与 sha256 指纹。
- **只读为本**:所有研究脚本默认不得写入妙手的安装目录与 userData 目录;
  唯一允许的写操作是仓库自己的目录与 `~/.modelmux/catpaw/`。
- **唯一出网口**:`catpaw` CLI 与网关按设计访问上游;新增任何出网代码前先问用户。
- **证据等级不可省**:任何结论必须带 `[实测]` / `[代码]` / `[推断]` / `[参考]` 标记
  (定义见 `docs/channels/catpaw/PROTOCOL.md`)。禁止把推断写成实测。
- **算法结论以代码为准**:不得靠长度/熵"猜"算法;必须给出 `app.asar` 里的实现片段。

## 机制约束

- TypeScript ≥ 5.9,严格模式,Node ≥ 22.6;零第三方运行依赖。
- `src/` 只有 7 个文件(`channel.ts` / `cli.ts` / `index.ts` / `cred.ts` /
  `upstream.ts` / `catalog.ts` / `billing.ts`),其余一律复用 `@modelmux/gateway`。
- 文本文件一律 **LF**(`.gitattributes` 已锁定)。
- 文档与代码同 commit 更新:改了阶段实现就要改对应文档。

## 改动前的检查

```bash
npm run build        # 编译到 dist/(tsc 严格模式)
npm run typecheck    # 类型检查
```
→ 渠道不写测试(`AGENTS.md` 的「测试规则」第 1 条):无 `tests/selftest.test.ts`,无 `scripts.test`。

全仓验证(在工作区根):

```bash
npm run build && npm run test --workspaces --if-present
```

涉及登录链路、上游协议翻译的改动,必须额外跑一次真实机器验证:
`mx login catpaw` → `mx status catpaw` → 一次真实流式 chat。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bluechonk/modelmux/packages/core/channels/catpaw/AGENTS.md@sha256:4abc291829271591

The line at the top of this page pins the label git:20261019.f7f08e1, 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_svcund45shw64jla.svg)](https://markdownregistry.com/a/art_svcund45shw64jla)

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

Versions

The registry has recorded 4 versions of this file, between Oct 17, 2026 and Oct 19, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261019.f7f08e1 latest2026-10-19 f7f08e1 2,023 BA view · diff
git:20261019.ae1118d2026-10-19 ae1118d 2,023 BA view · diff
git:20261018.bfc627a2026-10-18 bfc627a 1,996 BA view · diff
git:20261017.ff3f46b2026-10-17 ff3f46b 1,970 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 (2023 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

bluechonk/modelmux · 11 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_svcund45shw64jla
GET https://markdownregistry.com/api/v1/resolve?ref=bluechonk/modelmux/packages/core/channels/catpaw/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/4abc291829271591b8b4262cb152f7ffb7d7bf2856fcd196b141f7ef5e6aa4c2

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

claude-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/claude-mx-test/SKILL.md · 用 Claude Code 对 modelmux(mx)网关做端到端测试(Anthropic Messages 协议,/v1/messages + count_tokens)。适用于:用 claude 测 mx、claude code…
git:20261107.0bf381d · audit B · 11 stars
codex-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/codex-mx-test/SKILL.md · 用 Codex CLI 对 modelmux(mx)网关做端到端测试(OpenAI Responses 协议,/v1/responses)。适用于:用 codex 测 mx、codex 接入 modelmux、验证…
git:20261107.0bf381d · audit B · 11 stars
dsh-mx-test SKILL.md skill
bluechonk/modelmux · .agents/skills/dsh-mx-test/SKILL.md · 用 dsh(DeepSeek Harness)ACP 协议对 modelmux(mx)网关做端到端模型测试。适用于:用 dsh 测 mx、dsh 接入 modelmux、网关端到端验收、换 harness 复测模型、dsh…
git:20261106.f07736d · audit B · 11 stars
log-triage SKILL.md skill
bluechonk/modelmux · .agents/skills/log-triage/SKILL.md · modelmux 的日志排查与故障分诊流程。只要用户问“为什么这么慢 / 为什么失败 / 超时 / 卡住 / 网关挂了 / 日志在哪 / 怎么排查 / 看下日志”,或提到 request id、慢请求、502/503、stale…
git:20261106.f07736d · audit A · 11 stars
mx-cli SKILL.md skill
bluechonk/modelmux · .agents/skills/mx-cli/SKILL.md · modelmux 的 mx CLI 使用手册。用户要运行/查询/配置 mx(启动、重启、状态、模型、登录、账号池、额度、日志、Web 控制台、path),或不确定动词与渠道参数的顺序、该用 mx model list 还是 mx…
git:20261107.bc11d30 · audit B · 11 stars
repo-sync SKILL.md skill
bluechonk/modelmux · .agents/skills/repo-sync/SKILL.md · modelmux 仓库的收尾与同步流程:把一轮代码改动同步到 docs 文档、规划进度与 commit 历史,并在需要上线时走完分支 → PR → CI → squash merge → 删分支的闭环。用户说「收尾」「同步文档」「更新…
git:20261105.29cf971 · audit A · 11 stars
zcode-session-archaeology SKILL.md skill
bluechonk/modelmux · .agents/skills/zcode-session-archaeology/SKILL.md · 按 session id 或项目路径还原另一个 ZCode 会话做了什么(模型、轮次、工具调用、错误、最终结论、产物),用于多会话并行改同一个项目时的对齐、排查与收尾。当用户提到「另一个会话」「session_xxx /…
git:20261025.1f96581 · audit A · 11 stars
AGENTS.md AGENTS.md file
bluechonk/modelmux · AGENTS.md
git:20261107.bd0e3d9 · audit A · 11 stars
AGENTS.md@docs AGENTS.md file
bluechonk/modelmux · docs/AGENTS.md
git:20261105.36a6b70 · audit A · 11 stars

Every file in bluechonk/modelmux

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