AGENTS.mdA

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

Install it, pinned
mdr add licoy/quosparr/AGENTS.md@git:20261029.cd6c46d

Pins git:20261029.cd6c46d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
licoy/quosparr
Path
AGENTS.md
Versions recorded
21
Latest version
git:20261029.cd6c46d, committed Oct 29, 2026
First version recorded
Oct 16, 2026
Size
4,556 bytes
Repository stars
319
License
AGPL-3.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

本文件只记录适用于整个仓库的全局开发规范。

## 本文件的维护规则

- 严禁在本文件写入任何业务逻辑说明,包括但不限于:功能行为、界面流程、用户数据路径与文件格式、读写或删除边界、供应商差异、计价与统计口径、版本历史、迁移与升级事项
- 业务行为一律以实际代码为准:实现、测试与包级 doc 注释是唯一依据;需要固化的业务约束写进对应包的 doc 注释并用测试锁定,不写进本文件
- 文档(含本文件、README、`docs/`)与代码不一致时以代码为准,并在回复中指出不一致之处
- 新增条目前先确认它对整个仓库普遍适用;只对某个包或某项功能成立的规则不属于本文件

## 技术栈

- 主程序为 Go + mygo/ui 原生界面;Swift 只用于 macOS WidgetKit 扩展(`Sources/QuosparrWidget`)与桥接(`Sources/QuosparrWidgetBridge`),不新增 Swift 主应用代码或 SwiftPM 包
- Go 与依赖版本以 `go.mod` 为准;应用身份、平台最低版本与打包配置以 `mygo.json`、`WidgetExtension/project.yml` 为准,不在文档中重复具体数值
- Widget 工程由 `WidgetExtension/project.yml` 经 xcodegen 生成,除非用户明确要求,不另建 Xcode project
- 默认不引入第三方依赖,标准库和系统框架能解决的问题不加包;框架或依赖升级单独提交,不与其他改动混在一起
- 不引入 WebView 前端;purego 仅用于必要的平台 API、动态库与 Swift 桥接边界,按平台拆分并检查 ABI、资源生命周期与错误传播,不用它增加业务抽象

## 代码组织

- 入口为 `main.go`;原生 UI 与系统协调在 `internal/app`,业务模块按领域分包在 `internal/*`
- 业务包不依赖 UI;UI 只经业务包的 API 取结果,不直接解析文件或扫描目录
- 函数保持短小,优先简单结构体与函数,不做多 provider 抽象
- 新代码贴合周边代码的命名、注释密度与写法

## 本地化

- 用户可见文案经 `internal/l10n`(手工维护的 `tables.go`)或现有文案入口,新增 key 必须补齐英文、简体中文、繁体中文、韩文、日文、俄文、法文七种语言
- Widget 使用自带的 `Sources/QuosparrWidget/RunwayWidgetL10n.swift` 与快照类型副本,修改共享 key 或快照结构时与 Go 侧同步,同样保持七语言完整

## 隐私与安全
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add licoy/quosparr/AGENTS.md@sha256:bbdb375e527a7059

The line at the top of this page pins the label git:20261029.cd6c46d, 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_gm4o7kz2bnnq2tzr.svg)](https://markdownregistry.com/a/art_gm4o7kz2bnnq2tzr)

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

Versions

The registry has recorded 21 versions of this file, between Oct 16, 2026 and Oct 29, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261029.cd6c46d latest2026-10-29 cd6c46d 4,556 BA view · diff
git:20261029.18326622026-10-29 1832662 4,979 BA view · diff
git:20261029.6f565cc2026-10-29 6f565cc 44,258 BA view · diff
git:20261028.931f99e2026-10-28 931f99e 41,267 BA view · diff
git:20261028.b4d86e62026-10-28 b4d86e6 40,195 BA view · diff
git:20261026.143ba392026-10-26 143ba39 39,328 BA view · diff
git:20261026.e0084892026-10-26 e008489 37,886 BA view · diff
git:20261026.b6686ac2026-10-26 b6686ac 36,968 BA view · diff
git:20261022.4947e522026-10-22 4947e52 34,598 BA view · diff
git:20261022.47e95e42026-10-22 47e95e4 34,408 BA view · diff
git:20261021.2bed9432026-10-21 2bed943 34,271 BA view · diff
git:20261021.617ef2f2026-10-21 617ef2f 33,600 BA view · diff
git:20261021.6ce33222026-10-21 6ce3322 33,435 BA view · diff
git:20261021.e768f312026-10-21 e768f31 33,435 BA view · diff
git:20261021.a3385802026-10-21 a338580 32,759 BA view · diff
git:20261021.33584512026-10-21 3358451 32,366 BA view · diff
git:20261018.ff765812026-10-18 ff76581 28,221 BA view · diff
git:20261017.3d1d90c2026-10-17 3d1d90c 27,961 BA view · diff
git:20261017.117c2182026-10-17 117c218 27,006 BA view · diff
git:20261017.2660e9b2026-10-17 2660e9b 25,733 BA view · diff
git:20261016.5f01ee42026-10-16 5f01ee4 25,448 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 (4556 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

licoy/quosparr · 319 stars · license AGPL-3.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gm4o7kz2bnnq2tzr
GET https://markdownregistry.com/api/v1/resolve?ref=licoy/quosparr/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/bbdb375e527a7059240fdc200c49f484615e6a92f66c6e79da31225cf46e9cda

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.

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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