Restate Coding Agent Plugin and Skills

This is an early preview of the Restate Coding Agent Plugin. Please submit feedback (positive and negative) in the Restate Discord, Slack Community, or via issues in this repo.

A coding agent plugin for building applications with Restate — the durable execution runtime for resilient services, workflows, and AI agents.

Packaged for Claude Code, Cursor, and Codex. Works across four Restate SDKs: TypeScript, Python, Java, and Go.

What this plugin provides

• Two skills:
  • building-restate-services — activates automatically when you mention Restate concepts or open a Restate template. Detects your SDK from package.json, requirements.txt/pyproject.toml, pom.xml/build.gradle, or go.mod and loads the right reference on demand.
  • learn-restate-by-example — activates on learning intent ("teach me restate", "restate tutorial", "getting started with restate"). Picks a track based on what you're trying to build, clones the matching starter, and walks you through the stages hands-on.
• One MCP server (restate-docs) bound to https://docs.restate.dev/mcp for searching conceptual guides, deployment docs, server config, and advanced topics.

Install Plugin

The same plugin source ships manifests for Claude Code, Cursor, and Codex — all three live under plugins/restatedev/ and share one skills/ tree.

Claude Code

Add the marketplace and install the plugin from within Claude Code:

/plugin marketplace add restatedev/skills
/plugin install restatedev@restatedev-plugin

To verify, run /plugin — you should see restatedev-plugin listed as enabled.

Cursor

Cursor discovers the plugin via .cursor-plugin/marketplace.json at the repo root. Follow Cursor's plugin marketplace workflow to install from restatedev/skills. This plugin is not yet available via /add-plugin.

Codex

Add the marketplace:

codex plugin marketplace add restatedev/skills

Install the plugin through Codex's TUI: launch codex, run /plugins, find the Restate marketplace, select the Restate plugin, and choose Install. Restart Codex after install completes.

Other coding agents

To add the Restate skills to any coding agent:

npx skills add restatedev/skills

You will need to add the MCP server manually in this case. See .mcp.json.

Learning Restate

Install the plugin, open an empty directory, and type something like:

teach me restate

The learn-restate-by-example skill will ask a couple of questions (what are you trying to build, which language), pick a matching track (Quickstart, Tour of Workflows, Tour of Microservice Orchestration, or an AI agent on-ramp), clone the starter via restate example ..., start the Restate server and service, and walk you through the stages one at a time — running the curl commands and pointing at real files in the cloned repo. Once the tour ends, the building-restate-services skill takes over for actual implementation.

What it helps with

The building-restate-services skill triggers on mentions of Restate, durable execution, virtual objects, workflows, durable agents, and related terms.

Once active, it progressively loads references for:

Topic	Reference
SDK setup, API patterns, determinism rules, error handling, testing, pitfalls	references/<sdk>/api-and-pitfalls.md
Designing a new Restate application, picking service types	references/design-and-architecture.md
Migrating to Restate from other workflow orchestrators or general microservices applications	references/translate-to-restate.md
Invoking, cancelling, attaching, idempotency, sends, Kafka	references/invocation-lifecycle.md
Debugging stuck invocations and journal mismatches	references/debug-applications.md
AI agents with Vercel AI SDK (TS)	references/ts/restate-vercel-ai-agents.md
AI agents with OpenAI Agents SDK (Python)	references/python/restate-openai-agents-agents.md
AI agents with Google ADK (Python)	references/python/restate-google-adk-agents.md
AI agents with Pydantic AI (Python)	references/python/restate-pydantic-ai-agents.md

Paths above are relative to plugins/restatedev/skills/building-restate-services/.

Deployment, server configuration, Kafka setup, and other advanced topics are handled by querying the bundled restate-docs MCP server.

The learn-restate-by-example skill is organized as a set of tracks under plugins/restatedev/skills/learn-restate-by-example/references/: tracks.md (routing), prerequisites.md, quickstart.md, tour-of-workflows.md, tour-of-orchestration.md, ai-agents.md.

Contributing

Test the Claude Code plugin locally with:

claude --plugin-dir /path/to/this/repo/plugins/restatedev

For Cursor and Codex CLI, point their respective local-plugin flags at the same plugins/restatedev/ directory.

Note: The plugins/restatedev/skills/ folder in this repo is synced automatically every 12 hours from restatedev/docs-restate, where the skills are authored, tested, and updated. Edits made directly here will be overwritten — contribute changes upstream in docs-restate instead. Reference files live under plugins/restatedev/skills/building-restate-services/references/. When adding a new topic, link it from SKILL.md's context table so the skill knows when to load it.

Links

• Restate homepage: https://restate.dev
• Documentation: https://docs.restate.dev
• Service examples: https://github.com/restatedev/examples
• AI agent examples: https://github.com/restatedev/ai-examples
• SDK repos: sdk-typescript, sdk-python, sdk-java, sdk-go

License

MIT