# centrifugo

Skill for working with Centrifugo, a self-hosted real-time messaging server supporting WebSocket, SSE, and GRPC. Sets up channels, JWT authentication, backend publishing, and client subscriptions to live updates.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 263 installs · ★ 655 repo stars
- Author: pedronauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/curated/centrifugo/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/centrifugo

## What it does

Centrifugo runs as an expert guide across all listed platforms for building real-time transport layers. The server receives data from your backend via HTTP or GRPC Server API and broadcasts to WebSocket, SSE, or WebTransport subscribers. Channels are organized into namespaces, each controlling its own behavior: message history retention, presence tracking, recovery after disconnection. Clients connect with a JWT token issued by the backend.

The skill covers server configuration (HMAC keys, CORS, TLS), channel structure design, token generation in Python or Node.js, publishing through Server API, and connecting official SDKs (JavaScript, Go, Dart, Swift, Java, Python). It handles unidirectional publishing (backend pushes updates to channels), bidirectional proxying (client events validated by backend), and server-side subscriptions for personalized feeds.

For multi-node clusters, Centrifugo uses Redis or NATS as a message broker between instances. The skill helps you pick an integration pattern, write configuration, set up authentication, and deploy your first real-time channel.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill centrifugo -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/centrifugo/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/centrifugo/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill centrifugo -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/centrifugo/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill centrifugo -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/centrifugo/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/curated/centrifugo
```

2. **Manually: put the files in place**
- File: `.github/skills/centrifugo/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill centrifugo -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/curated/centrifugo
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/centrifugo/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill centrifugo -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/curated/centrifugo/SKILL.md

## When to use it
- deploy a self-hosted real-time server with WebSocket and SSE
- design channels with different history retention, presence, and recovery behavior
- issue JWT tokens for client connections from your backend
- publish messages to a channel via Server API and receive them on the client
- scale real-time updates across multiple servers using Redis or NATS

## Example prompts
- Show me how to configure Centrifugo with Redis for a multi-node cluster and generate a JWT token for a client.
- Write an endpoint that publishes to a notification channel and a WebSocket subscriber that listens to it.
- Help me organize namespaces for a chat and live course feed with different history retention and TTL settings.

## Similar
- [bun-websocket-server](https://affpapa.org/en/nevibecode/skills/bun-websocket-server.md) — skill · 411 installs
- [azure-messaging-webpubsubservice-py](https://affpapa.org/en/nevibecode/skills/azure-messaging-webpubsubservice-py.md) — skill · 1 install
- [websocket-engineer](https://affpapa.org/en/nevibecode/skills/websocket-engineer.md) — skill · 7300 installs
- [realtime-sync](https://affpapa.org/en/nevibecode/skills/realtime-sync.md) — skill · 108 installs
- [supabase-realtime-optimizer](https://affpapa.org/en/nevibecode/agents/supabase-realtime-optimizer.md) — subagent · 1346 installs
- [Realtime WebSocket taste](https://affpapa.org/en/nevibecode/prompts/realtime-websocket-taste.md) — prompt · ★ 178201 repo stars

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
