Voiden is a free, open source api development & testing project written in TypeScript and released under Apache-2.0. It has 1,755 GitHub stars, 80 forks and 38 open issues, and was last pushed 7 days ago. On this registry it ranks #81 of 103 tracked projects in API Development & Testing, with 5 head-to-head comparisons available. It gained 38 stars over the last 6 tracked days.

What is Voiden?

What it is

Voiden is an offline, Git-native API workspace built with Electron, TypeScript, and JavaScript. It lets developers, QA engineers, and technical writers design, test, document, and collaborate on APIs using plain text .void files. The project lives in the API development and testing ecosystem, and its topics describe it as an alternative to Bruno and Insomnia. It supports REST, GraphQL, gRPC, and WebSockets through plugins, and it imports collections from Postman, Insomnia, and Swagger or OpenAPI.

The concrete problem it solves is the split between API clients, documentation tools, test runners, and team workspaces. Voiden keeps requests, tests, notes, and documentation in the same executable file. It replaces opaque proprietary collections with Markdown-like text and reusable blocks, so API work can be versioned, reviewed, merged, and automated like source code. It removes required accounts and cloud sync, which makes the workspace usable offline and easier to place under Git control.

Key capabilities

  • It stores API requests, tests, notes, and documentation together in plain text .void files that can be diffed, grepped, and merged with Git.
  • It composes requests from reusable API blocks such as endpoints, authentication, parameters, and bodies, and those blocks can be reused across files.
  • It supports REST, GraphQL, gRPC, and WebSockets through plugins that can be installed or uninstalled according to the user's needs.
  • It runs JavaScript, Python, or Shell scripts before requests are sent and after responses are received, enabling custom request preparation and response checks.
  • It provides a Stitch runner and a headless CLI for Node.js 18 or newer, which can execute .void files in terminal, CI/CD, Docker, or cron jobs.

Who uses it and how

  • Developers use it as a local API client for designing and testing endpoints while keeping request definitions inside a repository.
  • QA engineers use scripting and the Stitch runner to execute batches of API tests and validate responses without leaving the workspace.
  • Teams use Git branches and pull requests for collaboration instead of proprietary team workspaces, which fits repositories that already use code review workflows.

Getting started

The typical install methods are desktop installers for macOS, Windows, and Linux, plus package managers such as Homebrew, APT, Snap, and Nix flakes. The Voiden Runner CLI can run .void files in terminal, CI/CD, Docker, and cron jobs.

When to use it — and when not to

Voiden fits local API workflows that need Git review, plain-text documentation, and scriptable execution without accounts or cloud sync. It is less suitable when teams need a proprietary team workspace, built-in cloud collaboration, or a mature product with a larger visible contributor base, since the repository shows zero listed contributors and a very young age. The Windows signing change can produce a SmartScreen warning during installation, which requires user confirmation even though the installer is described as signed and verified.

project readme (upstream, from github) — read inline

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.

Download Docs Changelog Blog

Discord X LinkedIn

License: Apache 2.0 Latest release

Contributors

Contributors

Voiden workspace showing requests, docs, and response panels

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.

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.1.0

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 installer is now signed via Azure Trusted Signing instead of our previous certificate provider. Because of this change, you may see a "Windows protected your PC" SmartScreen dialog during install — the installer is signed and verified, this is expected while the app builds up download reputation with Microsoft. Click "More info" → "Run anyway" to proceed.

Windows SmartScreen warning

Package managers

Platform Stable Early access
macOS brew install voiden brew install voiden@beta
Windows winget and Chocolatey coming soon winget and Chocolatey coming soon
Linux apt and snap support Beta apt and snap channels
Linux/macOS nix run github:VoidenHQ/voiden (Flake) Development shell with nix develop

Homebrew

brew install voiden
# beta
brew install voiden@beta

APT (Ubuntu / Debian)

curl -fsSL https://voiden.md/apt/stable/voiden.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/voiden.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/voiden.gpg] https://voiden.md/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/voiden.list
sudo apt update && sudo apt install voiden
# beta
curl -fsSL https://voiden.md/apt/beta/voiden.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/voiden-beta.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/voiden-beta.gpg] https://voiden.md/apt/beta beta main" | sudo tee /etc/apt/sources.list.d/voiden-beta.list
sudo apt update && sudo apt install voiden

Snap

sudo snap install voiden
# beta
sudo snap install voiden --channel=beta

Nix (Linux / macOS)

Run Voiden directly using Nix Flakes:

nix run github:VoidenHQ/voiden

Looking for newer builds? Check the early access section on voiden.md/download.

Get started with Voiden

  1. Install Voiden and open it. No signup or login is required.
  2. Create a .void file in any folder and add your request, docs, and reusable blocks.
  3. Run the request with Cmd+Enter or Ctrl+Enter, then commit the file to Git.

For a guided first run, see the Voiden quick start.

Coming from Postman and other tools?

If you already use Postman, you can bring your existing collections with you:

  1. In Postman, export your collection as JSON (v2.1 is recommended).
  2. Drag the exported JSON file into the Voiden file list on the left panel.
  3. Open the imported file and click Generate Voiden Files to create a folder of native .void files — one per request, with headers, auth, query params, path variables, bodies, and response examples preserved.

Full walkthrough: Postman Imports.

Using Swagger or Insomnia?

OpenAPI Imports. Insomnia Imports

What you can do

  • Build REST and HTTP requests with headers, query params, JSON/XML/YAML/form bodies, file uploads, and cURL import/export.
  • Work with GraphQL using schema import, a visual query builder, variables, and subscriptions.
  • Use WebSocket and gRPC workflows in the same workspace.
  • Add pre-request and post-response scripts in JavaScript, Python, or shell.
  • Run assertions and stitch multiple .void files into batch runs with aggregated results.
  • Import OpenAPI specs and Post

readme truncated — read the full docs on github

Frequently asked questions

Is Voiden free to use?

Voiden is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Voiden do?

Build APIs like code with Git-native workspace

What is Voiden written in?

Voiden is primarily written in TypeScript. Its source is publicly available at https://github.com/voidenhq/voiden, and it has 1,755 GitHub stars.