bluesky-socialbluesky-social/atproto/AGENTS.md

atproto

AGENTS.md9.7k starsChanged 13 days agoLicence not identifiedView on GitHub

This is the TypeScript reference implementation of AT Protocol, the decentralized social media protocol behind Bluesky. It is a pnpm monorepo (runtime floor Node.js ≥22) containing client libraries, schema/codegen tooling,…

Installs packages

Jun 23, 2023Як це все діло робе? Кожен ваш скіт, лайк і репост генерується за допомогою відкритої open source системи @atproto.com. Весь її програмний… — @mathan.dev26 likes and reposts · 1 reply
Aug 2, 2025When both you and your AI agent are confused about some TypeScript/Node thing you can check @divy.zone and @dholms.xyz & co work in… — @jacob.gold25 likes and reposts · 2 replies
Dec 11, 2024New branch created in bluesky-social/atproto: vouch-schemas — @skywatch.bsky.social15 likes and reposts · 1 reply
May 15, 2023our protocol work is all open source so if you're familiar with github, you can follow along with the literal PRs here… — @emilyliu.me15 likes and reposts
Dec 11, 2024New branch created in bluesky-social/atproto: hailey/add-trending-topics-cfg — @skywatch.bsky.social10 likes and reposts · 1 reply

45 more on Bluesky

Jun 5, 2023If you check the git blame on https://github.com/bluesky-social/atproto you can see where Jack made them insert ‘fascism = true’ into the… — @huwupy.kawaii.social9 likes and reposts
Oct 2, 2025do you mean … the platform that the article is talking about? … github.com/bluesky-soci... — @maxine.science8 likes and reposts
May 5, 2023@jay.bsky.team I noticed you're using Lerna v4 for https://github.com/bluesky-social/atproto. I help maintain it & we have v6 out since a… — @juri.dev8 likes and reposts · 2 replies
Jul 2, 2023いえ、ATProtocolはblueskyが使っているプロトコルで、ATPの上で動くCustom feedというTwitterでいうところのリストがありまして、多少コードを書く必要がありますが、自由度が高いのでお望みのもが作れる、かも！という話です！(手間ですけどね笑)… — @bisn.ucho-ten.net7 likes and reposts · 1 reply
Apr 19, 2023atproto in Typescript is the official protocol implementation by the Bluesky team: https://github.com/bluesky-social/atproto but here's a… — @emilyliu.me7 likes and reposts · 1 reply
May 15, 2023atproto the codebase at github.com/bluesky-social/atproto supports did:web and did:plc right now, but atproto the decentralised protocol… — @retr0.id6 likes and reposts · 2 replies
Jan 20, 2025Go check it on GitHub 😊 github.com/bluesky-soci... — @opmentalhealth.bsky.social5 likes and reposts · 2 replies
Nov 27, 2024...network. If people want this, they should write a detailed write-up and open a github issue on atproto here: github.com/bluesky-soci... — @lalitdhalia.com5 likes and reposts · 1 reply
Jan 15, 2025New branch created in bluesky-social/atproto: pnbx/feeds — @skywatch.bsky.social4 likes and reposts
Dec 11, 2024New branch created in bluesky-social/atproto: vouch-impl — @skywatch.bsky.social4 likes and reposts
Oct 16, 2026Reference implementation is open source, yeah — @gretchenleigh.zone3 likes and reposts · 1 reply
Jan 16, 2025New branch created in bluesky-social/atproto: divy/fix-unicast-check — @skywatch.bsky.social3 likes and reposts
Jan 2, 2025New branch created in bluesky-social/atproto: induction-firehose — @skywatch.bsky.social3 likes and reposts
Jan 2, 2025New branch created in bluesky-social/atproto: op-state-object — @skywatch.bsky.social3 likes and reposts
Nov 21, 2024you still haven't mentioned what you actually want to run so here's all of them github.com/bluesky-soci... github.com/bluesky-soci... — @futur.blue3 likes and reposts
Nov 7, 2024New branch created in bluesky-social/atproto: resolve-facets-parallel — @skywatch.bsky.social3 likes and reposts
Jul 25, 2023Ja, het protocol is wel ontwikkeld om decentraal te werken, maar er is nog niet echt software stabiel om dat te doen/hosten. Bovendien is… — @handle.invalid3 likes and reposts
Jan 23, 2025New branch created in bluesky-social/atproto: fix-proto-issue — @skywatch.bsky.social2 likes and reposts
Dec 31, 2024New branch created in bluesky-social/atproto: op-like-backend — @skywatch.bsky.social2 likes and reposts
Dec 26, 2024New branch created in bluesky-social/atproto: ozone-fix-tags-length — @skywatch.bsky.social2 likes and reposts
Dec 19, 2024New branch created in bluesky-social/atproto: mod-post-wrap — @skywatch.bsky.social2 likes and reposts
Dec 18, 2024New branch created in bluesky-social/atproto: denv-env-avatar-path-fix — @skywatch.bsky.social2 likes and reposts
Dec 17, 2024New branch created in bluesky-social/atproto: ozone-advanced-tag-filter — @skywatch.bsky.social2 likes and reposts
Nov 27, 2024X doesn’t use the open sourced code any longer. Meanwhile, here is the entire code base for Bluesky. You can download it and host your own… — @teisnet.bsky.social2 likes and reposts
Nov 13, 2024I like more meta posts about the working of Bluesky itself! Been low key nerding out and peeking into github.com/bluesky-soci... and… — @joyeecheung.bsky.social2 likes and reposts · 2 replies
Nov 11, 2024New branch created in bluesky-social/atproto: starter-pack-search-lexicon — @skywatch.bsky.social2 likes and reposts
Nov 4, 2024New branch created in bluesky-social/atproto: divy/lint-misc — @skywatch.bsky.social2 likes and reposts
Oct 31, 2024New branch created in bluesky-social/atproto: samuel/funky-facets — @skywatch.bsky.social2 likes and reposts
Oct 28, 2024New branch created in bluesky-social/atproto: divy/bsky-client-cfg — @skywatch.bsky.social2 likes and reposts
Oct 23, 2024New branch created in bluesky-social/atproto: msi/hackaton-monologue — @skywatch.bsky.social2 likes and reposts
Oct 17, 2024github.com/bluesky-soci... i mean if you wanna do it in js , you can use this to pull the posts, — @akitten.online2 likes and reposts · 2 replies
Oct 10, 2024New branch created in bluesky-social/atproto: ozone-admin-token-extension — @skywatch.bsky.social2 likes and reposts
Feb 8, 2024since they have their codebase open and they plan on federation in the coming month this shouldn't be a problem. github.com/bluesky-soci... — @asimon.org2 likes and reposts · 1 reply
Dec 26, 2023自分はこれで作った github.com/bluesky-soci... — @hiroy.kotori.style2 likes and reposts
Sep 8, 2023you might be able to find the source code for the feed search in the atproto repo github.com/bluesky-soci... — @jcsalterego.bsky.social2 likes and reposts · 1 reply
Jul 31, 2023A combination of atproto.com and reading their code https://github.com/bluesky-social/atproto — @syfaro.net2 likes and reposts
Jul 1, 2023what's the difference between a social network based on AT protocol (MIT license) #bluesky and one which is simply an open protocol #nostr… — @handle.invalid2 likes and reposts
Apr 28, 2023Its all in the typescript codebase here: https://github.com/bluesky-social/atproto I'm not very good at TS but I think its in packages/bsky? — @why.bsky.world2 likes and reposts · 1 reply
Mar 6, 2023https://github.com/bluesky-social/atproto https://github.com/bluesky-social/indigo — @fox.bsky.social2 likes and reposts
Nov 9, 2026well I've found like ~3 but I'm using: - tangled.org/zat.dev/zds - github.com/bluesky-soci... both using the containers by… — @jacky.wtf1 likes and repost · 1 reply
Feb 7, 2026Now, this is using github.com/bluesky-soci... and credentials aren't stored. It's an oauth token, which you can revoke by just logging out… — @colton-armstrong.bsky.social1 likes and repost · 1 reply
Jan 16, 2025New branch created in bluesky-social/atproto: use-ubuntu-22 — @skywatch.bsky.social1 likes and repost
Jan 14, 2025New branch created in bluesky-social/atproto: yolo/lex — @skywatch.bsky.social1 likes and repost
Dec 31, 2024New branch created in bluesky-social/atproto: bsky-did-web — @skywatch.bsky.social1 likes and repost
Dec 27, 2024New branch created in bluesky-social/atproto: update-crypto — @skywatch.bsky.social1 likes and repost

On GitHub · 41

Sep 24, 2025Mitigate discrimination/bullying against others via Block List erasure — bluesky-social/social-app30 reactions · 10 comments
Aug 3, 2023Polls — bluesky-social/social-app29 reactions · 1 comment
Sep 4, 2025📓 Bookmarks — bluesky-social/social-app20 reactions · 2 comments
Dec 11, 2024[Notifications] Add a Mentions tab — bluesky-social/social-app19 reactions · 6 comments
Dec 3, 2024Please add rel="me" support — bluesky-social/social-app14 reactions · 2 comments

36 more on GitHub

Nov 3, 2023Work around a startup stall caused by expo-image on low-end Android — bluesky-social/social-app14 reactions · 1 comment
Sep 26, 2023[APP-870] Compose intent URL — bluesky-social/social-app13 reactions · 2 comments
Jun 13, 2025PDS: ActivityPub identity interop — blacksky-algorithms/rsky12 reactions · 9 comments
Jan 7, 2025Add bookmarks natively to Bluesky — bluesky-social/social-app11 reactions · 22 comments
Aug 31, 2024Pinned posts — bluesky-social/social-app11 reactions · 3 comments
Mar 6, 2024By default, hide replies to people you don't follow in the Following feed — bluesky-social/social-app11 reactions
Dec 1, 2025Websocket streaming API — did-method-plc/did-method-plc9 reactions · 7 comments
Jul 21, 2026Add repost-only mutes — bluesky-social/social-app8 reactions · 7 comments
Jan 23, 2024De-dupe across different bridges — snarfed/bridgy-fed8 reactions · 23 comments
Nov 23, 2024Add a hotness thread sort — bluesky-social/social-app7 reactions · 2 comments
Oct 19, 2024New account labelling, and managing harassment, scams, etc. — bluesky-social/social-app7 reactions · 1 comment
Aug 23, 2024Draft OAuth Spec — bluesky-social/atproto-website7 reactions · 15 comments
Apr 11, 2023Add Bluesky support — snarfed/bridgy7 reactions · 50 comments
Sep 9, 2025Nomadic Identity — fedify-dev/fedify6 reactions · 1 comment
Aug 1, 2024Show quote posts — bluesky-social/social-app6 reactions · 4 comments
Nov 15, 2024Implementation Divergences — DavidBuchanan314/millipds5 reactions
Aug 17, 2024OAuth — frontpagefyi/frontpage5 reactions · 3 comments
Sep 25, 2026Quotes: Top / Latest tabs — bluesky-social/social-app4 reactions · 11 comments
Oct 9, 2025Tap (sync tool) — bluesky-social/indigo4 reactions · 1 comment
Apr 11, 2025Adds basic `enclosure` support for images and video — bluesky-social/social-app4 reactions · 3 comments
Dec 4, 2024specs: Account Hosting — bluesky-social/atproto-website4 reactions · 3 comments
Nov 10, 2023Switch subscription endpoint — bluesky-social/feed-generator4 reactions · 7 comments
Aug 11, 2026APP-2829 Update video lexicon and beta features for 10-minute uploads — bluesky-social/social-app3 reactions · 8 comments
Dec 22, 2025Tap Go Library — bluesky-social/indigo3 reactions · 1 comment
Apr 7, 2025Add rsky-relay — blacksky-algorithms/rsky3 reactions · 2 comments
Mar 11, 2025NSID: allow digits in 'name' segment — bluesky-social/atproto-website3 reactions
Mar 9, 2025server/constraints: Check blessed did:key algs — did-method-plc/did-method-plc3 reactions · 3 comments
Jun 10, 2024replace graphemer by unicode-segmenter — bluesky-social/social-app3 reactions · 3 comments
Apr 27, 2024Patch lexicon for perf — bluesky-social/social-app3 reactions · 3 comments
Apr 17, 2024Movable following feed — bluesky-social/social-app3 reactions · 3 comments
Aug 3, 2023[APP-786] Native notifications — bluesky-social/social-app3 reactions · 1 comment
Apr 5, 2026[APP-2044] Gate image blob size increase — bluesky-social/social-app2 reactions · 2 comments
Mar 10, 2026Add Lex SDK to schema documentation — standard-schema/standard-schema2 reactions · 3 comments
Jan 3, 2026pds v0.4.201 — bluesky-social/pds2 reactions
Oct 31, 2024Show muted word in `ContentHider` — bluesky-social/social-app2 reactions · 3 comments
Sep 2, 2024:bug: Allow Only/Exclude/Indifferent filters for appeal status — bluesky-social/ozone2 reactions · 1 comment

On Hacker News · 7

Nov 7, 2023Bluesky migrates to single-tenant SQLite354 points · 233 comments
Nov 20, 2024Call for Developer Projects91 points · 35 comments
Jul 13, 2023Bluesky now checks against this array of slurs when creating a username34 points · 84 comments
Dec 10, 2025ATProto Early Permission Sets3 points
Jun 28, 2024Protocol Tech Debt3 points · 1 comment

2 more on Hacker News

Aug 9, 2023Bluesky Reserved Names3 points
May 6, 2023Atproto is quiet when asked “why not nomad protcol”2 points · 1 comment

On the web · 2

Oct 16, 2024Bluesky and the AT Protocol: Usable Decentralized Social ... — arxiv.org
Nov 1, 2022github.com-bluesky-social-atproto_-_2022-11-01_00-41-52 — archive.org

On Stack Overflow · 1

Apr 15, 2025Bluesky social oauth scope "Bad token scope"1 vote

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,439 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository10 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- lex-clientSkill
- lex-dataSkill
- lexification-clientSkill
- lexification-serverSkill
- lex-schemaSkill
- lex-setupSkill
- playwrightSkill
- testingSkill
- xrpc-serverSkill

The file

We split this AGENTS.md into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.

The licence could not be identified — read it at the source. We count its rules but don't quote them. Read them on GitHub.

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free