# protopack

a claude code plugin for building AT Protocol applications.

## requirements

[uv](https://docs.astral.sh/uv/) must be installed — two of the bundled MCP servers run via `uvx`.

```bash
# macOS / linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# or homebrew
brew install uv
```

## install

```bash
/plugin marketplace add https://tangled.org/zzstoatzz.io/protopack.git
/plugin install protopack
```

## what's included

### skills

| skill | what it does |
|-------|-------------|
| `/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 |
| `/protopack:app-patterns` | common patterns for building atproto apps |

### bundled MCP servers

| server | what it does | transport |
|--------|-------------|-----------|
| [pdsx](https://github.com/zzstoatzz/pdsx) | AT Protocol record CRUD (list, get, create, update, delete) | `uvx` (PyPI) |
| [atproto-mcp](https://github.com/ashex/atproto-mcp) | searchable atproto docs, lexicon schemas, cookbook examples | `uvx` (PyPI) |
| [pub-search](https://pub-search.waow.tech) | 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

```bash
claude --plugin-dir ./protopack
```

## credits

- [microcosm.blue](https://microcosm.blue) — AT Protocol infrastructure by [@bad-example.com](https://bsky.app/profile/bad-example.com)
- [pdsx](https://github.com/zzstoatzz/pdsx) — AT Protocol record operations
- [atproto-mcp](https://github.com/ashex/atproto-mcp) — AT Protocol documentation search
- [pub-search](https://pub-search.waow.tech) — atmosphere publishing search
- [wisp.place](https://wisp.place) — static site hosting on AT Protocol by [@nekomimi.pet](https://bsky.app/profile/nekomimi.pet)