VoidenHQ / voiden
git clone https://github.com/VoidenHQ/voiden.git
v2.3.4 · today
Design, Test and Document APIs in plain Markdown. Compose Requests with API blocks. Reuse, Replace & Version everything just like code. Offline, Truly Git Native, No Lock-in.
+15
stars, 24h · #2,404
+~75
stars, 7 days · #2,807
+~320
stars, 30 days · #2,557
1.9k
★ total · +4% this week
87
forks · 23 open issues
Star history (as recorded here)
LanguageTypeScript
LicenseApache-2.0
Created2025-05-09 (1y ago)
Last pushtoday
Watchers9
OwnerOrganization
GitHub topics
api-clientautomationbruno-alternativeclicurl-alternativegraphqlhttp-clientinsomnia-alternativemarkdownmcp-clientmcp-toolsoffline-firstopenapiopenapi3opensourcepostman-alternativerest-apiscriptingtestingwebsocket
Links
- GitHub: github.com/VoidenHQ/voiden
- Homepage: https://voiden.md
- Releases · Issues · Hacker News mentions
README excerpt
Voiden : The offline, Git-native API workspace. Build, test, document, and collaborate on APIs with plain-text .void files. No accounts. No required cloud sync. Just local files, reusable blocks, and Git. Contributors ## Why Voiden Voiden is an offline API client that helps developers, QA and technical writers build, test, collaborate and document APIs in one place. With a programmable interface (/slash commands) and an agent-friendly CLI, Voiden adapts to how engineers already work. Voiden is built with Electron, Typescript and Javascript, and it doesnt require an account to use it. No telemetry, no VC funding, and no cloud lock-in. ✨ Features: Voiden supports all major API protocols: - Supports REST, GraphQL, Grpc, Web-Sockets. All these are plugins that you can install or uninstall according to your needs. Community plugins available: https://voiden.md/plugins - Import collections from Postman, Insomnia and Swagger/ OpenAPI. Single Source of truth for all API work in the same file: - Keep API requests, tests, notes and docs together in the same executable`.void` files. Keep everything in one format and one workflow. - Requests can be composed by API building blocks (endpoint, auth, params, body). Decompose requests into blocks. Reuse the same blocks across files, like functions. - Work in Markdown and structured blocks instead of opaque collections locked inside an app. - Test and document APIs without leaving the editor. Workflows: - Scripting: Execute JavaScript, Python, or Shell scripts before sending requests and after receiving responses. - Stitch runner: Batch-execute multiple .void files sequentially. Supports glob patterns, stop-on-failure, variable isolation, configurable delays, and environment selection. Collaboration: - Collaborate with Git branches and pull requests instead of proprietary team workspaces. - Stay local-first with no signup and no required cloud sync. AI Friendly: - No proprietary workspace. No binary exports. Pure text all the way down, diffable like code, greppable, AI-editable, and merge-friendly. - Supports Voiden skills for Claude and Codex agents. - MCP support — connect Claude Code or Codex directly to a project so they can run your `.void` requests themselves, or serve your own requests as tools other agents can call. See the MCP docs. Voiden Runner: A headless CLI for running those .void files outside the desktop app, directly in the terminal. - runs on Node.js 18+ - works in terminal, CI/CD, Docker, and cron jobs - supports REST, WebSocket, gRPC, and GraphQL - supports request chaining through runtime variables - works with core Voiden plugins like scripting, assertions, faker, advanced auth, + more. ## Install **Current version:** `2.3.3` (stable) Download installers for macOS, Windows, and Linux from voiden.md/download. Direct downloads are available for Apple Silicon and Intel macOS, Windows `.exe`, and Linux `.deb`, `.rpm`, and `.AppImage` builds. > **Windows note (starting v2.1.1):** the Windows