zzstoatzz.io
protopack#
a plugin for building AT Protocol applications, for Claude Code and Codex.
requirements#
uv must be installed — two of the bundled MCP servers run via uvx.
# macOS / linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# or homebrew
brew install uv
install#
claude code#
/plugin marketplace add https://tangled.org/zzstoatzz.io/protopack.git
/plugin install protopack
codex#
codex plugin marketplace add https://tangled.org/zzstoatzz.io/protopack.git
codex plugin add protopack@protopack
what's included#
skills#
| skill | what it does |
|---|---|
/protopack:microcosm-patterns |
orientation + how to compose the services to build atproto apps |
/protopack:constellation |
query the global backlink index (likes, reposts, follows, replies, quotes) |
/protopack:spacedust |
real-time interaction streaming via WebSocket |
/protopack:slingshot |
fast record fetching and identity resolution |
/protopack:ufos |
lexicon timeseries statistics and ecosystem discovery |
/protopack:pub-search |
search published writing across the atmosphere for prior art |
/protopack:wisp |
deploy static sites to AT Protocol via wisp.place |
bundled MCP servers#
| server | what it does | transport |
|---|---|---|
| pdsx | AT Protocol record CRUD (list, get, create, update, delete) | uvx (PyPI) |
| atproto-mcp | searchable atproto docs, lexicon schemas, cookbook examples | uvx (PyPI) |
| pub-search | search published writing across atmosphere platforms | hosted HTTP |
microcosm services#
| service | url | purpose |
|---|---|---|
| constellation | constellation.microcosm.blue | global backlink index |
| spacedust | spacedust.microcosm.blue | real-time interaction firehose |
| slingshot | slingshot.microcosm.blue | record/identity cache |
| ufos | ufos-api.microcosm.blue | lexicon timeseries stats |
local development#
from a clone of this repo:
claude --plugin-dir . # Claude Code
skills auto-publish to vit on push to main (only the ones that changed) via .tangled/workflows/publish-skills.yml.
credits#
- microcosm.blue — AT Protocol infrastructure by @bad-example.com
- pdsx — AT Protocol record operations
- atproto-mcp — AT Protocol documentation search
- pub-search — atmosphere publishing search
- wisp.place — static site hosting on AT Protocol by @nekomimi.pet