Home / muselinn / musepi · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from muselinn/musepi.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Development Rules

## GUI Development Rules (`packages/desktop-app`, `packages/guest-client`)

The desktop GUI follows its own living spec — **`docs/gui-design.md`** (design/interaction standards) and **`docs/gui-implementation.md`** (RPC contracts, gotchas, verification workflow). Update them when you change GUI behavior. Key rules that bite:

- **Modals must own the keyboard while open.** `DialogFrame` captures Escape on `document` in the capture phase (wins over handlers behind), moves focus into the dialog and restores it on close; confirm boxes confirm on Enter; the onboarding overlay advances on Enter / steps back on Escape. Never let a modal rely on the page behind keeping focus — the composer swallows Enter and sends a message.
- **`DialogFrame` is always mounted and driven by `open`** — conditional mounting (`{x && <DialogFrame/>}`) kills the exit animation. Same rule for prompt/confirm dialogs (`lib/prompt-dialog.tsx`): closing defers the promise resolution until the 180ms exit plays.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add muselinn/musepi/AGENTS.md@git:20260917.391022e
Exact content
mdr add muselinn/musepi/AGENTS.md@sha256:97b07eaa281c73cf

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260917.391022e latest2026-09-17 391022e 32,911 BA view · diff
git:20260916.ae02ea62026-09-16 ae02ea6 31,048 BA view · diff
git:20260909.1dfc4d62026-09-09 1dfc4d6 30,640 BA view · diff
git:20260827.0d870da2026-08-27 0d870da 30,626 BA view · diff
git:20260827.1f1cfc72026-08-27 1f1cfc7 30,565 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (32911 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

muselinn/musepi · 17 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6br43rqc5wkjgvii
GET https://markdownregistry.com/api/v1/resolve?ref=muselinn/musepi/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/97b07eaa281c73cf311984530572d2a3e04851595b720c8032d6d2c9c36cfdf3

Your agent 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.

More from muselinn/musepi

musepi-code-review skill
muselinn/musepi · .agents/skills/musepi-code-review/SKILL.md · 按 MusePi 仓库标准评审 PR/改动——AGENTS.md 代码质量规则(无 ReturnType、禁内联 import、prompt 进 .md)、GUI 规则(DialogFrame、hook…
git:20260916.ae02ea6 · audit A · 17 stars
musepi-find-simplifications skill
muselinn/musepi · .agents/skills/musepi-find-simplifications/SKILL.md · 在 MusePi 代码库找非显然的简化点——无生产消费者的公开方法/事件/配置项/helper、两个表示镜像同一事实、投机通用化、手搓重复中央工具或 Bun 内置的实现;产出有证据的候选清单(评审过、可进 PR +…
git:20260823.0df9512 · audit A · 17 stars
musepi-prose-standard skill
muselinn/musepi · .agents/skills/musepi-prose-standard/SKILL.md · MusePi 代码库的文案/注释标准——写"契约"而不是写过程:删推理过程、重复和装饰,一处事实一个家;覆盖 JSDoc、代码注释、prompt .md、i18n 文案、GUI…
git:20260909.1dfc4d6 · audit A · 17 stars
musepi-trim-cot-leakage skill
muselinn/musepi · .agents/skills/musepi-trim-cot-leakage/SKILL.md · 清理"思维链泄漏"类文案——死设计会话引用((决策 N)、审计码、草稿 §N、T4/P-I 阶段标签)、PR/栈视角("这个 PR 加了…")、变更叙述("以前/不再/旧版/这版")、评审对白("评审中否了…")、控制流叙述、含糊推迟("大…
git:20260823.0df9512 · audit A · 17 stars
semantic-compression skill
muselinn/musepi · .musepi/skills/semantic-compression/SKILL.md · Re-encode verbose prose into a dense telegraphic register — punctuation as connectives, label frames, verbless…
git:20260823.eb76001 · audit A · 17 stars
system-prompts skill
muselinn/musepi · .musepi/skills/system-prompts/SKILL.md · Write system prompts, tool docs, and agent definitions. Project tag conventions + RFC 2119 keywords + dense…
git:20260916.c9f8599 · audit A · 17 stars
tool-prompt-optimization skill
muselinn/musepi · .musepi/skills/tool-prompt-optimization/SKILL.md · Optimize the description prompts an AI agent reads to learn its built-in tools (the `.md` files under prompts/tools/)…
git:20260823.eb76001 · audit A · 17 stars
board-design skill
muselinn/musepi · packages/coding-agent/src/bundled-skills/board-design/SKILL.md · 桌面看板(board)的设计与读写规范——何时建板、怎么规划卡片布局、如何选 widget 类型并配 data/pos(避免类型数据错配和不可用布局)。触发:用户要求"看板/桌面卡片墙/把 X 放上看板/添加卡片"。
git:20260817.88c4ebc · audit A · 17 stars
musepi-contributing skill
muselinn/musepi · packages/coding-agent/src/bundled-skills/musepi-contributing/SKILL.md · MusePi 仓库提交规范助手——帮用户按项目模板与 CONTRIBUTING 规范起草/提交 GitHub issue、pull request、commit message 与 changelog,以及跑 release…
git:20260908.1c958e3 · audit A · 17 stars
musepi-extension-dev skill
muselinn/musepi · packages/coding-agent/src/bundled-skills/musepi-extension-dev/SKILL.md · 为 MusePi(TUI/CLI + 桌面 GUI)开发扩展——custom tools、extensions(生命周期/事件)、hooks、plugins、slash…
git:20260817.c5cdd0e · audit A · 17 stars
musepi-help skill
muselinn/musepi · packages/coding-agent/src/bundled-skills/musepi-help/SKILL.md · MusePi 产品使用帮助——回答"怎么用/是什么/出问题怎么办"类问题(TUI/CLI/桌面 GUI/看板/widget/配置/扩展/许可)。触发:任何关于 MusePi 本身的使用、功能、配置、故障问题。
git:20260909.1dfc4d6 · audit A · 17 stars
ui-ux-pro-max skill
muselinn/musepi · packages/coding-agent/src/bundled-skills/ui-ux-pro-max/SKILL.md · UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing…
git:20260817.88c4ebc · audit A · 17 stars

Every file in muselinn/musepi

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

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