Dex Developer is the official coding-agent skill for building, debugging, testing, and operating applications with Superdurable Dex. It covers the public Dex programming model in Python, Go, Java, TypeScript, and Rust.
The skill uses progressive disclosure. Shared guidance lives under
references/core/; each supported language has a matching ten-topic handbook
under references/<language>/. An agent first loads the selected language's
entry page, then only the modeling, primitives, patterns, testing, operations,
data, versioning, or advanced guidance needed for the task.
This repository is the single source of truth for the dex-developer skill.
The dex plugin packages that skill for Codex, Claude Code, and Cursor without
adding an MCP server, hooks, or application runtime dependencies.
codex plugin marketplace add superdurable/skill-dex-developer
codex plugin add dex@superdurableStart a new task after installation. Invoke the skill with $dex-developer, or
let Codex select it for Dex application work.
Run these commands inside Claude Code:
/plugin marketplace add superdurable/skill-dex-developer
/plugin install dex@superdurable
/reload-plugins
Invoke the skill with /dex:dex-developer.
Cursor loads the portable Agent Plugin in plugins/dex. Until it is listed in
the public Cursor Marketplace, import this repository into a team marketplace
or install the skill directly:
npx skills add superdurable/skill-dex-developer --skill dex-developerFor local plugin development, link plugins/dex into
~/.cursor/plugins/local/dex, then restart Cursor or run Developer: Reload
Window. Invoke the skill with /dex-developer, or let Cursor select it.
npx skills add superdurable/skill-dex-developer --skill dex-developerReleases use semantic versions. Agents load an installed or cached copy; they do not fetch the latest GitHub content for every prompt.
- Codex: upgrade the
superdurablemarketplace, reinstalldex@superdurable, and start a new task. - Claude Code: update the marketplace and run
/reload-plugins. Third-party marketplace auto-update can also be enabled in the plugin UI. - Cursor: refresh or reinstall the marketplace plugin. Team marketplaces can enable Auto Refresh. Reload the window when testing a local plugin update.
- Direct skill installs: rerun the
npx skills addcommand.
The skill version describes this guidance package, not the installed Dex SDK. The skill requires the agent to inspect the project's installed SDK and version-matched runnable examples before choosing exact APIs.
Exact API excerpts and runnable-source links are pinned to the Dex release tag recorded in DEX_BASELINE. CI checks out that tag and verifies that every marked snippet is a contiguous excerpt of its declared source file.
The baseline makes the handbook reproducible; it does not override the SDK installed by a user's project. When versions differ, the project dependency, lockfile, installed SDK source, and matching tagged examples take precedence.
The shared core covers architecture, getting started, modeling, primitives, StepOptions and durability, pattern selection, testing, troubleshooting, operations, versioning, data handling, and durable AI agents. Each language handbook covers setup and a minimal vertical slice, primitives, the full pattern catalog, integration testing, typed errors, durable data, observability, versioning, gotchas, and advanced features such as heartbeats, cancellation, selective loading, locks, BlobCache, and asynchronous durability.
See CONTRIBUTING.md for validation and release rules. The plugin is distributed under the MIT License.