AGENTS.mdB

AGENTS.md from pubky/pubky-app is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add pubky/pubky-app/AGENTS.md@git:20261022.0af4367

Pins git:20261022.0af4367 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
pubky/pubky-app
Path
AGENTS.md
Versions recorded
19
Latest version
git:20261022.0af4367, committed Oct 22, 2026
First version recorded
Jul 29, 2026
Size
13,677 bytes
Repository stars
26
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

# Pubky App

Decentralized social app: Next.js 16 App Router, React 19 with the React Compiler, TypeScript, Tailwind v4 + Shadcn UI, Zustand,
Dexie (IndexedDB), TanStack Query. Package name `franky`. Local-first: writes go to Dexie first and sync to the homeserver;
reads come from Dexie and fall back to Nexus. This file is the entry point for every AI agent (Claude Code, Codex, Cursor);
it indexes `docs/`, which is canonical and wins over anything here (`docs/development-workflow.md` is the long version).

## Commands

Node 24 (`.nvmrc`), dependencies via `npm ci`. The pre-commit hook runs `lint-staged` then `npm run typecheck`.

| Task                    | Command                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| Dev server (port 3000)  | `npm run dev` (staging defaults are built in, no `.env` needed)                                |
| Format, lint, types     | `npm run format:check`, `npm run lint`, `npm run typecheck`                                    |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pubky/pubky-app/AGENTS.md@sha256:bb96a0d406c6c2ef

The line at the top of this page pins the label git:20261022.0af4367, 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_i2zmsv73uftssafx.svg)](https://markdownregistry.com/a/art_i2zmsv73uftssafx)

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

Versions

The registry has recorded 19 versions of this file, between Jul 29, 2026 and Oct 22, 2026, about one every 5 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20261022.0af4367 latest2026-10-22 0af4367 13,677 BB view · diff
git:20261022.d7611e32026-10-22 d7611e3 13,386 BB view · diff
git:20261019.d061f402026-10-19 d061f40 13,140 BB view · diff
git:20261012.a49050f2026-10-12 a49050f 12,726 BB view · diff
git:20261010.1efb2032026-10-10 1efb203 12,620 BB view · diff
git:20261009.f54b19a2026-10-09 f54b19a 12,428 BB view · diff
git:20261001.c78e0862026-10-01 c78e086 12,517 BB view · diff
git:20260929.b49c8132026-09-29 b49c813 12,385 BB view · diff
git:20260926.26c4eca2026-09-26 26c4eca 12,235 BB view · diff
git:20260923.a27e4202026-09-23 a27e420 12,006 BB view · diff
git:20260918.b35cf7a2026-09-18 b35cf7a 11,960 BB view · diff
git:20260917.8de93302026-09-17 8de9330 11,886 BB view · diff
git:20260915.d786bb42026-09-15 d786bb4 11,834 BB view · diff
git:20260915.89954f52026-09-15 89954f5 9,055 BA view · diff
git:20260907.aaba2b82026-09-07 aaba2b8 7,120 BA view · diff
git:20260902.51b89ce2026-09-02 51b89ce 6,894 BA view · diff
git:20260813.f8fa15f2026-08-13 f8fa15f 6,794 BA view · diff
git:20260810.46eefa52026-08-10 46eefa5 6,613 BA view · diff
git:20260729.128e0312026-07-29 128e031 6,609 BA view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No instruction to read or print local credentials (matched: read `process.env)
  • pass: Size between 200 bytes and 200 KB (13677 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 base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

pubky/pubky-app · 26 stars · license MIT · pushed 2026-11-06 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_i2zmsv73uftssafx
GET https://markdownregistry.com/api/v1/resolve?ref=pubky/pubky-app/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/bb96a0d406c6c2efe27a0d13edb4575d52a33e992fb8985961dd3acef28d707e

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 pubky/pubky-app

pubky-code-review SKILL.md skill
pubky/pubky-app · .agents/skills/pubky-code-review/SKILL.md · Run a local code review of a diff against this repo's architecture rules (AGENTS.md, .greptile/config.json) and quality…
git:20261009.f54b19a · audit A · 26 stars
pubky-staging-invite SKILL.md skill
pubky/pubky-app · .agents/skills/pubky-staging-invite/SKILL.md · Mints a single-use signup token for the Pubky staging homeserver. Use when the user explicitly asks for a new staging…
git:20260915.d786bb4 · audit A · 26 stars
sentry-nextjs-sdk SKILL.md skill
pubky/pubky-app · .agents/skills/sentry-nextjs-sdk/SKILL.md · Full Sentry SDK setup for Next.js. Use when asked to "add Sentry to Next.js", "install @sentry/nextjs", or configure…
git:20260507.298cb6e · audit A · 26 stars
architecture Cursor rule
pubky/pubky-app · .cursor/rules/architecture.mdc · Core architecture rules - layer separation, dependencies, and anti-patterns
git:20260309.80c3cb2 · audit B · 26 stars
commit-message Cursor rule
pubky/pubky-app · .cursor/rules/commit-message.mdc · Enforce conventional commit message format
git:20260309.80c3cb2 · audit B · 26 stars
component-testing Cursor rule
pubky/pubky-app · .cursor/rules/component-testing.mdc · Writing unit tests for UI component rendering
git:20261009.f54b19a · audit B · 26 stars
components Cursor rule
pubky/pubky-app · .cursor/rules/components.mdc · Component development patterns - Shadcn first, atomic design, Figma parity
git:20260309.80c3cb2 · audit B · 26 stars
data-patterns Cursor rule
pubky/pubky-app · .cursor/rules/data-patterns.mdc · Data patterns - composite IDs, streams, TTL, pipes normalization
git:20260915.d786bb4 · audit B · 26 stars
env-variables Cursor rule
pubky/pubky-app · .cursor/rules/env-variables.mdc · Build-time Env and runtime PUBKY_RUNTIME_* configuration rules
git:20260915.d786bb4 · audit A · 26 stars
error-handling Cursor rule
pubky/pubky-app · .cursor/rules/error-handling.mdc · Error handling conventions using AppError across all layers
git:20260915.d786bb4 · audit B · 26 stars
local-first Cursor rule
pubky/pubky-app · .cursor/rules/local-first.mdc · Local-first write patterns and controller naming conventions
git:20260915.d786bb4 · audit B · 26 stars
pwa Cursor rule
pubky/pubky-app · .cursor/rules/pwa.mdc · PWA / service worker — shell-only precache, no data caching, user-consented updates, static offline fallback, manifest…
git:20260918.b35cf7a · audit A · 26 stars

Every file in pubky/pubky-app

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 B, or by owner.