Durable Objects

This is the skill you reach for when you need state that sticks around between requests and belongs to a specific key: a chat room, a leaderboard, a rate limiter, a long-running agent. Each instance gets its own in-memory state plus a transactional KV store, and you can attach WebSockets directly to it. The constraints are tight: one TypeScript file per class, no npm imports, PascalCase class names that map to kebab-case URLs. You deploy once and instances spin up on demand per ID. Works well for multiplayer rooms or per-user agents where you need guaranteed single-threaded execution and can't tolerate the cold-start shuffle of stateless functions. Just remember that cross-instance coordination is on you.

Install to Claude Code

npx -y skills add butterbase-ai/butterbase-skills --skill durable-objects --agent claude-code