Skip to content
Back to search

spikard

Codegen-first polyglot web toolkit: one Rust core, 14 language bindings, spec-driven codegen (OpenAPI, AsyncAPI, GraphQL, gRPC, SQL to HTTP) and a 13-tool MCP server. Experimental, pre-1.0, MIT.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Goldziher/spikard with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Goldziher/spikard'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/goldziher--spikard/badge.svg)](/listings/goldziher--spikard)

HTML

<a href="/listings/goldziher--spikard"><img src="/api/listings/goldziher--spikard/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Each binding ships through its native package manager.

| Target | Package | Install | | ------- | -------------------------------------- | ---------------------------------------------------- | | Rust | `spikard` on crates.io | `cargo add spikard` | | CLI | `spikard-cli` on crates.io | `cargo install spikard-cli` or `cargo binstall spikard-cli` | | Python | `spikard` on PyPI | `pip install spikard` | | Node.js | `@spikard/node` on npm | `pnpm add @spikard/node` | | WASM | `@spikard/node-wasm` on npm | `pnpm add @spikard/node-wasm` | | Ruby | `spikard` on RubyGems | `gem install spikard` | | PHP | `goldziher/spikard` on Packagist | `composer require goldziher/spikard` | | Elixir | `spikard` on Hex | Add `{:spikard, "~> 0.17"}` to `mix.exs` | | Go | `github.com/Goldziher/spikard` | `go get github.com/Goldziher/spikard` | | Java | `dev.spikard:spikard` on Maven Central | Maven/Gradle — see [Java README](packages/java) | | C# | `Spikard` on NuGet | `dotnet add package Spikard` | | Kotlin | `dev.spikard:spikard` on Maven Central | Maven/Gradle — see [Kotlin README](packages/kotlin) | | Dart | `spikard` on pub.dev | `dart pub add spikard` | | Swift | `Spikard` via SwiftPM | Add to `Package.swift` | | Zig | `spikard` via `build.zig.zon` | Add to build manifest | | C FFI | `spikard-ffi` shared/static library | [GitHub Releases](https://github.com/Goldziher/spikard/releases) |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "spikard",
  3. "description": "Spikard code generation and HTTP framework agent tools",
  4. "owner": {
  5. "name": "Goldziher"
  6. },
  7. "plugins": [
  8. {
  9. "name": "spikard",
  10. "description": "Generate HTTP applications, schema handlers and fixtures using Spikard's local CLI and MCP server.",
  11. "source": "./plugin"
  12. }
  13. ]
  14. }
README.md · README · 283 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- markdownlint-disable MD033 MD041 -->
  2. <div align="center">
  3. <img src="https://raw.githubusercontent.com/Goldziher/spikard/main/docs/assets/spikard-banner.svg" alt="spikard - polyglot web toolkit" width="820">
  4. **One web toolkit, every language.**
  5. Codegen-first polyglot web toolkit. A Rust core plus 14 language bindings generated by alef — spec-driven codegen (OpenAPI, AsyncAPI, GraphQL, JSON-RPC, gRPC, and SQL→HTTP), type-safe routing, tower-http middleware, an MCP server for coding agents, and fixture-driven cross-language testing.
  6. **Rust core** · Python · TypeScript · Ruby · PHP · Elixir · Go · Java · C# · Kotlin · Dart · Swift · Zig · WASM · C FFI
  7. <div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
  8. <!-- Built with alef -->
  9. <a href="https://github.com/xberg-io/alef">
  10. <img src="https://img.shields.io/badge/built%20with-alef%20%D7%90-007ec6?style=flat-square" alt="Built with alef">
  11. </a>
  12. <!-- Language bindings -->
  13. <a href="https://crates.io/crates/spikard">
  14. <img src="https://img.shields.io/crates/v/spikard?color=007ec6&style=flat-square" alt="Rust">
  15. </a>
  16. <a href="https://pypi.org/project/spikard/">
  17. <img src="https://img.shields.io/pypi/v/spikard?color=007ec6&style=flat-square" alt="Python">
  18. </a>
  19. <a href="https://www.npmjs.com/package/@spikard/node">
  20. <img src="https://img.shields.io/npm/v/@spikard/node?color=007ec6&style=flat-square" alt="Node.js">
  21. </a>
  22. <a href="https://www.npmjs.com/package/@spikard/node-wasm">
  23. <img src="https://img.shields.io/npm/v/@spikard/node-wasm?color=007ec6&style=flat-square" alt="WASM">
  24. </a>
  25. <a href="https://rubygems.org/gems/spikard">
  26. <img src="https://img.shields.io/gem/v/spikard?color=007ec6&style=flat-square" alt="Ruby">
  27. </a>
  28. <a href="https://packagist.org/packages/goldziher/spikard">
  29. <img src="https://img.shields.io/packagist/v/goldziher/spikard?color=007ec6&style=flat-square" alt="PHP">
  30. </a>
  31. <a href="https://hex.pm/packages/spikard">
  32. <img src="https://img.shields.io/hexpm/v/spikard?color=007ec6&style=flat-square" alt="Elixir">
  33. </a>
  34. <a href="https://central.sonatype.com/artifact/dev.spikard/spikard">
  35. <img src="https://img.shields.io/maven-central/v/dev.spikard/spikard?color=007ec6&style=flat-square" alt="Java">
  36. </a>
  37. <a href="https://github.com/Goldziher/spikard/releases">
  38. <img src="https://img.shields.io/github/v/tag/Goldziher/spikard?label=Go&color=007ec6&style=flat-square" alt="Go">
  39. </a>
  40. <a href="https://www.nuget.org/packages/Spikard/">
  41. <img src="https://img.shields.io/nuget/v/Spikard?color=007ec6&style=flat-square" alt="C#">
  42. </a>
  43. <a href="https://central.sonatype.com/artifact/dev.spikard/spikard">
  44. <img src="https://img.shields.io/maven-central/v/dev.spikard/spikard?label=Kotlin&color=007ec6&style=flat-square" alt="Kotlin">
  45. </a>
  46. <a href="https://pub.dev/packages/spikard">
  47. <img src="https://img.shields.io/pub/v/spikard?color=007ec6&style=flat-square" alt="Dart">
  48. </a>
  49. <a href="https://github.com/Goldziher/spikard/tree/main/packages/swift">
  50. <img src="https://img.shields.io/badge/Swift-Spikard-007ec6?style=flat-square" alt="Swift">
  51. </a>
  52. <a href="https://github.com/Goldziher/spikard/tree/main/packages/zig">
  53. <img src="https://img.shields.io/badge/Zig-spikard-007ec6?style=flat-square" alt="Zig">
  54. </a>
  55. <a href="https://github.com/Goldziher/spikard/tree/main/crates/spikard-ffi">
  56. <img src="https://img.shields.io/badge/C%20FFI-007ec6?style=flat-square" alt="C FFI">
  57. </a>
  58. <a href="https://github.com/Goldziher/homebrew-tap">
  59. <img src="https://img.shields.io/badge/Homebrew-007ec6?style=flat-square&logo=homebrew&logoColor=white" alt="Homebrew">
  60. </a>
  61. <!-- Project info -->
  62. <a href="https://github.com/Goldziher/spikard/blob/main/LICENSE">
  63. <img src="https://img.shields.io/badge/License-MIT-007ec6?style=flat-square" alt="License">
  64. </a>
  65. </div>
  66. [Install](#installation) · [Why spikard](#why-spikard) · [Quick example](#quick-example) · [MCP server](#mcp-server) · [Docs](https://spikard.dev)
  67. </div>
  68. ---
  69. > [!IMPORTANT]
  70. > **spikard is experimental and pre-1.0.** APIs change between releases, and not every binding is at
  71. > the same level of maturity. It is not yet recommended for production.
  72. >
  73. > That is also the invitation: this is the point where feedback actually shapes the design. If you try
  74. > it and something is wrong, awkward, or missing, please
  75. > [open an issue](https://github.com/Goldziher/spikard/issues). If you want to help,
  76. > [good first issues](https://github.com/Goldziher/spikard/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
  77. > are scoped to be finishable in an evening, and [CONTRIBUTING.md](CONTRIBUTING.md) explains the
  78. > generated-bindings workflow.
  79. ## Why spikard
  80. | Capability | Details |
  81. |---|---|
  82. | **Type-safe across bindings** | HTTP routing with path, query, body, and header validation. Errors convert losslessly between languages. |
  83. | **Polyglot bindings** | Python, TypeScript/Node, Ruby, PHP, Elixir, Go, Java, C#, Kotlin, Dart, Swift, Zig, WASM, Rust, and C FFI. |
  84. | **Schema codegen** | Parse OpenAPI 3.0, AsyncAPI 3.0, GraphQL SDL, and JSON-RPC 2.0 specs. Generate handlers and validators per binding. |
  85. | **SQL to HTTP codegen** | Annotate SQL queries with `@http GET /path`, `@http_auth bearer:jwt`, and emit route metadata and OpenAPI specs. |
  86. | **Tower middleware** | Compression, rate limiting, timeouts, request IDs, JWT/API-key auth, and static file serving. |
  87. | **Lifecycle hooks** | `onRequest`, `preValidation`, `preHandler`, `onResponse`, and `onError`. |
  88. | **WebSocket & SSE** | Bidirectional streams and server-sent events. |
  89. | **Fixture-driven testing** | Shared JSON fixtures drive tests across language bindings for behavioral consistency. |
  90. | **CLI & MCP server** | Initialize projects, generate code, validate schemas, and integrate with MCP-compatible tools. |
  91. ## Installation
  92. Each binding ships through its native package manager.
  93. <!-- markdownlint-disable MD013 -->
  94. | Target | Package | Install |
  95. | ------- | -------------------------------------- | ---------------------------------------------------- |
  96. | Rust | `spikard` on crates.io | `cargo add spikard` |
  97. | CLI | `spikard-cli` on crates.io | `cargo install spikard-cli` or `cargo binstall spikard-cli` |
  98. | Python | `spikard` on PyPI | `pip install spikard` |
  99. | Node.js | `@spikard/node` on npm | `pnpm add @spikard/node` |
  100. | WASM | `@spikard/node-wasm` on npm | `pnpm add @spikard/node-wasm` |
  101. | Ruby | `spikard` on RubyGems | `gem install spikard` |
  102. | PHP | `goldziher/spikard` on Packagist | `composer require goldziher/spikard` |
  103. | Elixir | `spikard` on Hex | Add `{:spikard, "~> 0.17"}` to `mix.exs` |
  104. | Go | `github.com/Goldziher/spikard` | `go get github.com/Goldziher/spikard` |
  105. | Java | `dev.spikard:spikard` on Maven Central | Maven/Gradle — see [Java README](packages/java) |
  106. | C# | `Spikard` on NuGet | `dotnet add package Spikard` |
  107. | Kotlin | `dev.spikard:spikard` on Maven Central | Maven/Gradle — see [Kotlin README](packages/kotlin) |
  108. | Dart | `spikard` on pub.dev | `dart pub add spikard` |
  109. | Swift | `Spikard` via SwiftPM | Add to `Package.swift` |
  110. | Zig | `spikard` via `build.zig.zon` | Add to build manifest |
  111. | C FFI | `spikard-ffi` shared/static library | [GitHub Releases](https://github.com/Goldziher/spikard/releases) |
  112. <!-- markdownlint-enable MD013 -->
  113. ## Quick example
  114. ### Python
  115. ```python
  116. from spikard import Spikard
  117. from msgspec import Struct
  118. class User(Struct):
  119. id: int
  120. name: str
  121. app = Spikard()
  122. @app.get("/users/{id:int}")
  123. async def get_user(id: int) -> User:
  124. return User(id=id, name="Alice")
  125. if __name__ == "__main__":
  126. app.run(port=8000)
  127. ```
  128. ### TypeScript
  129. ```typescript
  130. import { Spikard } from "@spikard/node";
  131. const app = new Spikard();
  132. app.get("/users/{id:int}", async (id: number) => {
  133. return { id, name: "Alice" };
  134. });
  135. app.run({ port: 8000 });
  136. ```
  137. <details>
  138. <summary><strong>More examples</strong> (Ruby · PHP · Elixir · Go · Java · C# · Kotlin · Dart · Swift)</summary>
  139. See the [examples directory](https://github.com/Goldziher/spikard/tree/main/crates/spikard-http/examples) in the repository for working examples in every supported language.
  140. </details>
  141. ## MCP server
  142. The CLI ships an [MCP](https://modelcontextprotocol.io) server so a coding agent can scaffold and
  143. generate spikard projects directly. It is enabled by default (`spikard-cli` feature `mcp`) and speaks
  144. stdio out of the box; streamable HTTP is available via the `mcp-http` feature.
  145. ```json
  146. {
  147. "mcpServers": {
  148. "spikard": {
  149. "command": "spikard",
  150. "args": ["mcp"]
  151. }
  152. }
  153. }
  154. ```
  155. Thirteen tools are exposed, covering project init, codegen from every supported spec format, the
  156. SQL→HTTP pipeline, AsyncAPI fixture and test-app generation, schema validation, and a feature summary.
  157. See the [MCP documentation](https://spikard.dev/mcp/) for the full tool list and worked flows.
  158. ## Coding agent plugins
  159. Install the curated Spikard plugin for Claude, Codex, Cursor, Gemini, Kimi, OpenCode, Pi, Hermes, Factory, Agent Plugins and Copilot. It includes the public `skills/spikard` skill and six API references; MCP-enabled clients connect to the installed local CLI. See the [installation guide](docs/guides/agent-plugins.md) and [plugin publishing setup](.github/PLUGIN-PUBLISHING.md).
  160. ## SQL to HTTP
  161. Annotate a SQL query and spikard emits the route, an OpenAPI 3.1 fragment, and a typed handler stub
  162. that calls into the generated query function:
  163. ```sql
  164. -- @name GetUser
  165. -- @returns :one
  166. -- @http GET /users/{id}
  167. -- @http_auth bearer:jwt
  168. SELECT id, name, email FROM users WHERE id = $1;
  169. ```
  170. Query parsing and type inference come from [scythe](https://github.com/Goldziher/scythe); spikard
  171. reads scythe's analyzed-query IR and overlays the HTTP vocabulary on top. scythe stays
  172. library-agnostic and owns no HTTP concepts. See the
  173. [SQL codegen guide](https://spikard.dev/guides/sql-codegen/).
  174. ## Architecture
  175. All bindings call a shared Rust core through thin language-native layers:
  176. <details>
  177. <summary><strong>How bindings work</strong></summary>
  178. ```text
  179. Language bindings (Python, Node, Ruby, Go, Java, C#...)
  180. |
  181. v
  182. FFI / NAPI / PyO3 / Magnus / runtime bridge
  183. |
  184. v
  185. crates/spikard-http Router, middleware, auth
  186. crates/spikard-core HTTP types, validation, errors
  187. crates/spikard-codegen OpenAPI, GraphQL, AsyncAPI, JSON-RPC
  188. ```
  189. Bindings are generated from the Rust API surface via [alef](https://github.com/xberg-io/alef). Binding code stays thin: type conversion, error conversion, and runtime integration. Business logic, validation, middleware, and codegen all live in Rust.
  190. </details>
  191. <details>
  192. <summary><strong>Specification support</strong></summary>
  193. - **OpenAPI 3.0** — Route definitions to specs, parameter validators, Swagger/ReDoc UI
  194. - **GraphQL** — SDL schema parsing, query execution, introspection, Handler trait integration
  195. - **AsyncAPI 3.0** — Channel/operation extraction, message validators, WebSocket integration
  196. - **OpenRPC** — JSON-RPC 2.0 method handlers, parameter validation, batch requests
  197. </details>
  198. <details>
  199. <summary><strong>Middleware stack</strong></summary>
  200. Compression (gzip/brotli), rate limiting, timeouts, request IDs, authentication (JWT/API key), static files. Configured via ServerConfig structs. All middleware is implemented in Rust via tower-http.
  201. </details>
  202. ## Development
  203. ```bash
  204. mise run setup # Install dependencies
  205. mise run build # Build Rust core (debug)
  206. mise run test # Run Rust tests
  207. mise run test:all # Run all tests (Rust + bindings)
  208. mise run e2e:all # Generate + build + run e2e tests
  209. mise run format # Format all code
  210. ```
  211. Run `mise tasks ls` for the full task catalog.
  212. <details>
  213. <summary><strong>Project status</strong></summary>
  214. - Experimental and pre-1.0 — see the note at the top of this README. APIs change between releases.
  215. - Binding packages follow the Rust crate version.
  216. - E2E coverage is fixture-driven and shared across supported language targets.
  217. - See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on modifying generated bindings.
  218. </details>
  219. ## License
  220. MIT License — see [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.