# protopack

a plugin for building AT Protocol applications, for Claude Code and Codex.

the bundled MCP servers are hosted HTTP — no local runtime or dependencies to install.

## install

### claude code

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

### codex

```bash
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:tangled` | work with Tangled repos, pulls, knots, spindles, and CI |
| `/protopack:constellation` | query the global backlink index (likes, reposts, follows, replies, quotes) |
| `/protopack:jetstream` | choose a client for live record feeds, archive replay, and recovery |
| `/protopack:spacedust` | real-time interaction streaming via WebSocket |
| `/protopack:slingshot` | fast record fetching and identity resolution |
| `/protopack:hubble` | whole-network repository snapshots and sync diagnostics |
| `/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](https://github.com/zzstoatzz/pdsx) | AT Protocol record CRUD (list, get, create, update, delete) | hosted HTTP |
| [pub-search](https://pub-search-by-zzstoatzz.fastmcp.app/mcp) | search published writing across atmosphere platforms | hosted HTTP |
| [tangled-mcp](https://github.com/zzstoatzz/tangled-mcp) | Tangled repository, Git, issue, pull, and pipeline operations | 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 |
| hubble | hubble.microcosm.blue | whole-Atmosphere repository mirror |

## local development

from a clone of this repo:

```bash
claude --plugin-dir .                 # Claude Code
```

## 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
- [pub-search](https://pub-search-by-zzstoatzz.fastmcp.app/mcp) — atmosphere publishing search
- [wisp.place](https://wisp.place) — static site hosting on AT Protocol by [@nekomimi.pet](https://bsky.app/profile/nekomimi.pet)