Substrait Claudecode Plugin

Substrait plugin for Claude Code

Build apps to the Substrait upload/deploy contract and ship them without leaving the terminal. The plugin bundles:

• the substrait-app skill — scaffolds a contract-compliant app (FastAPI backend/ on port 8000, cicd/ Dockerfiles, optional React+Vite+Tailwind frontend/, Flyway migrations); and
• seven slash commands:
  • /substrait:init — initialize the current folder as a Substrait project: scaffold a new app in an empty folder, or audit and convert an existing codebase to the deploy contract — then link it to an app.
  • /substrait:login — authenticate this machine with your Substrait account (mints the personal access token; one browser authorization, no copy/paste).
  • /substrait:logout — sign this machine out again: revokes the login-minted token on the portal and drops the stored credential (--project also unbinds this folder).
  • /substrait:link — link this project to one of your apps (pick or create it), so deploys know where to ship. Headless/CI falls back to pasting a token.
  • /substrait:deploy — deploy the project to the linked app: source-only zip upload, or a pushed-branch trigger for GitHub-connected apps (--watch to follow the build).
  • /substrait:env — view and set the linked app's environment variables and secrets (secrets are write-only; changes live-apply to a running app).
  • /substrait:library — browse the platform's API Library and design an app against existing APIs.

Install

/plugin marketplace add substrait-build/substrait-claudecode-plugin
/plugin install substrait@substrait

**Using the Claude desktop app?** The `/plugin` commands are terminal-only. Run the two commands above once from the `claude` CLI in any terminal — CLI and desktop share the same plugin store (`~/.claude/plugins`), so the plugin is immediately available in desktop sessions too. (Alternatively, use the desktop plugin manager