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.
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
Markdown
[](/listings/goldziher--spikard)HTML
<a href="/listings/goldziher--spikard"><img src="/api/listings/goldziher--spikard/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
- {
- "name": "spikard",
- "description": "Spikard code generation and HTTP framework agent tools",
- "owner": {
- "name": "Goldziher"
- },
- "plugins": [
- {
- "name": "spikard",
- "description": "Generate HTTP applications, schema handlers and fixtures using Spikard's local CLI and MCP server.",
- "source": "./plugin"
- }
- ]
- }
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.
- <!-- markdownlint-disable MD033 MD041 -->
- <div align="center">
- <img src="https://raw.githubusercontent.com/Goldziher/spikard/main/docs/assets/spikard-banner.svg" alt="spikard - polyglot web toolkit" width="820">
- **One web toolkit, every language.**
- 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.
- **Rust core** · Python · TypeScript · Ruby · PHP · Elixir · Go · Java · C# · Kotlin · Dart · Swift · Zig · WASM · C FFI
- <div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
- <!-- Built with alef -->
- <a href="https://github.com/xberg-io/alef">
- <img src="https://img.shields.io/badge/built%20with-alef%20%D7%90-007ec6?style=flat-square" alt="Built with alef">
- </a>
- <!-- Language bindings -->
- <a href="https://crates.io/crates/spikard">
- <img src="https://img.shields.io/crates/v/spikard?color=007ec6&style=flat-square" alt="Rust">
- </a>
- <a href="https://pypi.org/project/spikard/">
- <img src="https://img.shields.io/pypi/v/spikard?color=007ec6&style=flat-square" alt="Python">
- </a>
- <a href="https://www.npmjs.com/package/@spikard/node">
- <img src="https://img.shields.io/npm/v/@spikard/node?color=007ec6&style=flat-square" alt="Node.js">
- </a>
- <a href="https://www.npmjs.com/package/@spikard/node-wasm">
- <img src="https://img.shields.io/npm/v/@spikard/node-wasm?color=007ec6&style=flat-square" alt="WASM">
- </a>
- <a href="https://rubygems.org/gems/spikard">
- <img src="https://img.shields.io/gem/v/spikard?color=007ec6&style=flat-square" alt="Ruby">
- </a>
- <a href="https://packagist.org/packages/goldziher/spikard">
- <img src="https://img.shields.io/packagist/v/goldziher/spikard?color=007ec6&style=flat-square" alt="PHP">
- </a>
- <a href="https://hex.pm/packages/spikard">
- <img src="https://img.shields.io/hexpm/v/spikard?color=007ec6&style=flat-square" alt="Elixir">
- </a>
- <a href="https://central.sonatype.com/artifact/dev.spikard/spikard">
- <img src="https://img.shields.io/maven-central/v/dev.spikard/spikard?color=007ec6&style=flat-square" alt="Java">
- </a>
- <a href="https://github.com/Goldziher/spikard/releases">
- <img src="https://img.shields.io/github/v/tag/Goldziher/spikard?label=Go&color=007ec6&style=flat-square" alt="Go">
- </a>
- <a href="https://www.nuget.org/packages/Spikard/">
- <img src="https://img.shields.io/nuget/v/Spikard?color=007ec6&style=flat-square" alt="C#">
- </a>
- <a href="https://central.sonatype.com/artifact/dev.spikard/spikard">
- <img src="https://img.shields.io/maven-central/v/dev.spikard/spikard?label=Kotlin&color=007ec6&style=flat-square" alt="Kotlin">
- </a>
- <a href="https://pub.dev/packages/spikard">
- <img src="https://img.shields.io/pub/v/spikard?color=007ec6&style=flat-square" alt="Dart">
- </a>
- <a href="https://github.com/Goldziher/spikard/tree/main/packages/swift">
- <img src="https://img.shields.io/badge/Swift-Spikard-007ec6?style=flat-square" alt="Swift">
- </a>
- <a href="https://github.com/Goldziher/spikard/tree/main/packages/zig">
- <img src="https://img.shields.io/badge/Zig-spikard-007ec6?style=flat-square" alt="Zig">
- </a>
- <a href="https://github.com/Goldziher/spikard/tree/main/crates/spikard-ffi">
- <img src="https://img.shields.io/badge/C%20FFI-007ec6?style=flat-square" alt="C FFI">
- </a>
- <a href="https://github.com/Goldziher/homebrew-tap">
- <img src="https://img.shields.io/badge/Homebrew-007ec6?style=flat-square&logo=homebrew&logoColor=white" alt="Homebrew">
- </a>
- <!-- Project info -->
- <a href="https://github.com/Goldziher/spikard/blob/main/LICENSE">
- <img src="https://img.shields.io/badge/License-MIT-007ec6?style=flat-square" alt="License">
- </a>
- </div>
- [Install](#installation) · [Why spikard](#why-spikard) · [Quick example](#quick-example) · [MCP server](#mcp-server) · [Docs](https://spikard.dev)
- </div>
- ---
- > [!IMPORTANT]
- > **spikard is experimental and pre-1.0.** APIs change between releases, and not every binding is at
- > the same level of maturity. It is not yet recommended for production.
- >
- > That is also the invitation: this is the point where feedback actually shapes the design. If you try
- > it and something is wrong, awkward, or missing, please
- > [open an issue](https://github.com/Goldziher/spikard/issues). If you want to help,
- > [good first issues](https://github.com/Goldziher/spikard/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
- > are scoped to be finishable in an evening, and [CONTRIBUTING.md](CONTRIBUTING.md) explains the
- > generated-bindings workflow.
- ## Why spikard
- | Capability | Details |
- |---|---|
- | **Type-safe across bindings** | HTTP routing with path, query, body, and header validation. Errors convert losslessly between languages. |
- | **Polyglot bindings** | Python, TypeScript/Node, Ruby, PHP, Elixir, Go, Java, C#, Kotlin, Dart, Swift, Zig, WASM, Rust, and C FFI. |
- | **Schema codegen** | Parse OpenAPI 3.0, AsyncAPI 3.0, GraphQL SDL, and JSON-RPC 2.0 specs. Generate handlers and validators per binding. |
- | **SQL to HTTP codegen** | Annotate SQL queries with `@http GET /path`, `@http_auth bearer:jwt`, and emit route metadata and OpenAPI specs. |
- | **Tower middleware** | Compression, rate limiting, timeouts, request IDs, JWT/API-key auth, and static file serving. |
- | **Lifecycle hooks** | `onRequest`, `preValidation`, `preHandler`, `onResponse`, and `onError`. |
- | **WebSocket & SSE** | Bidirectional streams and server-sent events. |
- | **Fixture-driven testing** | Shared JSON fixtures drive tests across language bindings for behavioral consistency. |
- | **CLI & MCP server** | Initialize projects, generate code, validate schemas, and integrate with MCP-compatible tools. |
- ## Installation
- Each binding ships through its native package manager.
- <!-- markdownlint-disable MD013 -->
- | 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) |
- <!-- markdownlint-enable MD013 -->
- ## Quick example
- ### Python
- ```python
- from spikard import Spikard
- from msgspec import Struct
- class User(Struct):
- id: int
- name: str
- app = Spikard()
- @app.get("/users/{id:int}")
- async def get_user(id: int) -> User:
- return User(id=id, name="Alice")
- if __name__ == "__main__":
- app.run(port=8000)
- ```
- ### TypeScript
- ```typescript
- import { Spikard } from "@spikard/node";
- const app = new Spikard();
- app.get("/users/{id:int}", async (id: number) => {
- return { id, name: "Alice" };
- });
- app.run({ port: 8000 });
- ```
- <details>
- <summary><strong>More examples</strong> (Ruby · PHP · Elixir · Go · Java · C# · Kotlin · Dart · Swift)</summary>
- 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.
- </details>
- ## MCP server
- The CLI ships an [MCP](https://modelcontextprotocol.io) server so a coding agent can scaffold and
- generate spikard projects directly. It is enabled by default (`spikard-cli` feature `mcp`) and speaks
- stdio out of the box; streamable HTTP is available via the `mcp-http` feature.
- ```json
- {
- "mcpServers": {
- "spikard": {
- "command": "spikard",
- "args": ["mcp"]
- }
- }
- }
- ```
- Thirteen tools are exposed, covering project init, codegen from every supported spec format, the
- SQL→HTTP pipeline, AsyncAPI fixture and test-app generation, schema validation, and a feature summary.
- See the [MCP documentation](https://spikard.dev/mcp/) for the full tool list and worked flows.
- ## Coding agent plugins
- 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).
- ## SQL to HTTP
- Annotate a SQL query and spikard emits the route, an OpenAPI 3.1 fragment, and a typed handler stub
- that calls into the generated query function:
- ```sql
- -- @name GetUser
- -- @returns :one
- -- @http GET /users/{id}
- -- @http_auth bearer:jwt
- SELECT id, name, email FROM users WHERE id = $1;
- ```
- Query parsing and type inference come from [scythe](https://github.com/Goldziher/scythe); spikard
- reads scythe's analyzed-query IR and overlays the HTTP vocabulary on top. scythe stays
- library-agnostic and owns no HTTP concepts. See the
- [SQL codegen guide](https://spikard.dev/guides/sql-codegen/).
- ## Architecture
- All bindings call a shared Rust core through thin language-native layers:
- <details>
- <summary><strong>How bindings work</strong></summary>
- ```text
- Language bindings (Python, Node, Ruby, Go, Java, C#...)
- |
- v
- FFI / NAPI / PyO3 / Magnus / runtime bridge
- |
- v
- crates/spikard-http Router, middleware, auth
- crates/spikard-core HTTP types, validation, errors
- crates/spikard-codegen OpenAPI, GraphQL, AsyncAPI, JSON-RPC
- ```
- 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.
- </details>
- <details>
- <summary><strong>Specification support</strong></summary>
- - **OpenAPI 3.0** — Route definitions to specs, parameter validators, Swagger/ReDoc UI
- - **GraphQL** — SDL schema parsing, query execution, introspection, Handler trait integration
- - **AsyncAPI 3.0** — Channel/operation extraction, message validators, WebSocket integration
- - **OpenRPC** — JSON-RPC 2.0 method handlers, parameter validation, batch requests
- </details>
- <details>
- <summary><strong>Middleware stack</strong></summary>
- 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.
- </details>
- ## Development
- ```bash
- mise run setup # Install dependencies
- mise run build # Build Rust core (debug)
- mise run test # Run Rust tests
- mise run test:all # Run all tests (Rust + bindings)
- mise run e2e:all # Generate + build + run e2e tests
- mise run format # Format all code
- ```
- Run `mise tasks ls` for the full task catalog.
- <details>
- <summary><strong>Project status</strong></summary>
- - Experimental and pre-1.0 — see the note at the top of this README. APIs change between releases.
- - Binding packages follow the Rust crate version.
- - E2E coverage is fixture-driven and shared across supported language targets.
- - See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on modifying generated bindings.
- </details>
- ## License
- MIT License — see [LICENSE](LICENSE) for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.