deterministic

Description

A Claude Code skill that drives the deterministic codegen REST API (https://deterministic-code.com) from your terminal. Generates backend scaffolding (types, services, routes, migrations, OpenAPI docs) per language and per step, then unzips the result into your working tree.

Languages live on the API today: typescript, rust, and csharp (migrate scripts only — full parity in progress).

Quick start

Claude Code

Install the skill into ~/.claude/skills/ and put a generate binary on your $PATH:

curl -sSL https://deterministic-code.com/install-skills.sh | sh -s -- --bin deterministic

Cursor

Run from the project root you want the skill active in. The installer drops the skill payload (scripts + assets) into ~/.cursor/skills/deterministic/, symlinks generate into ~/.local/bin/, and writes a Cursor rule at <CWD>/.cursor/rules/deterministic.mdc so Cursor the IDE actually reads the skill instructions:

curl -sSL https://deterministic-code.com/install-skills-cursor.sh | sh -s -- --bin deterministic

Pass --no-mdc to skip the rule install (CLI-only). Override the rule target with CURSOR_RULES_DIR=~/.cursor/rules curl ... for a user-level install (modern Cursor versions). Remember to commit .cursor/rules/deterministic.mdc or add it to .gitignore.

Windows

Pick the shell you're using — each is a single command, no extra setup:

PowerShell (Windows 10 1803+ / 11) — Claude Code:

iwr -useb https://deterministic-code.com/install-skills.ps1 | iex

Installs into %USERPROFILE%\.claude\skills\, drops %USERPROFILE%\.local\bin\generate.cmd, and adds that bin dir to your User PATH. Open a new PowerShell window to pick up the PATH change. Requires node on PATH.

PowerShell — Cursor:

iwr -useb https://deterministic-code.com/install-skills-cursor.ps1 | iex

Run from the project root. Drops skill payload into %USERPROFILE%\.cursor\skills\, writes <CWD>\.cursor\rules\deterministic.mdc for Cursor the IDE, and adds %USERPROFILE%\.local\bin to your User PATH. Set $env:CURSOR_INSTALL_MDC = "0" BEFORE the iex to skip the rule install.

Git Bash (ships with Git for Windows) and WSL:

curl -sSL https://deterministic-code.com/install-skills.sh | sh -s -- --bin deterministic

Same one-liner as macOS/Linux. Symlinks ~/.local/bin/generate (which resolves to %USERPROFILE%\.local\bin\generate for Git Bash). Make sure that dir is on your PATH. Swap to install-skills-cursor.sh for the Cursor target.

First-time project setup

From the root of any new project, bootstrap the YAML folder + config in one shot:

generate setup

That writes deterministic.config.json and scaffolds deterministic/{datasource_types,view_types,services,routes,app}.yaml. Then edit deterministic/datasource_types.yaml to declare your tables and run generate against your saved backend.

Options forward to the underlying scripts: --api-url <prod|local|url>, --backend <id-or-name>, --languages <csv>, --datasources <csv>, --force (overwrite existing YAML).

List every <language> <step> combo the live API supports:

generate list

Run a specific codegen cell against one of your saved backends:

generate <language> <step> --backend <id-or-name>

Examples:

generate typescript migrate_scripts --backend my-app
generate rust routes --backend my-app
generate csharp migrate_scripts --backend my-app
generate _ validate                    # shared step, no language

No aliases — use canonical language names (typescript, rust, csharp) and step names (app, sql, openapi_docs, migrate_scripts, datasource_types, …). Run generate list for the full set.

generate help