Voiden – API Workflows as Markdown Files (Obsidian × Curl)

We open sourced Voiden a few months ago: an offline API tool where API requests live as executable Markdown and are versioned in Git.

The goal, when we set out to build Voiden, was simple - to combine the power and flexibility of Obsidian-style files with the simplicity of curl. Instead of static forms, requests are composed with blocks (endpoint, auth, params, body) that you can reuse, override, and stitch together across files (more like functions than requests).

Since open sourcing, most of what we have built has come directly from how people actually use it (11K installs). Most of the feedback, requests and contributions were around defining workflows, chaining requests, scripting them, and structuring everything in reusable .void files.

- Real scripting, not sandboxes: In most API tools scripting lives in a constrained JS sandbox, an environment that doesn't take advantage of powerful runtimes that might be available locally for a developer. The biggest limitation here is the assumption that the tool should define the runtime. Voiden runs fully locally, so this allows you to just run your scripts with actual runtimes (JS, Python, shell, with support for others being added).

- Multiple requests per file (mini workflows): Allowing multiple requests in a single .void file turned out to be surprisingly useful. Instead of scattering related requests, you can group them naturally: an order flow (create - pay - confirm), or a full CRUD cycle in one place. The file effectively becomes an executable flow: run one request, or the entire sequence end-to-end. And since Voiden is executable Markdown, docs and tests are in the same `.void` file that can be organised better, preventing duplication and drift.

- Stitch (composable workflows across files): Instead of a single large collection, workflows (“Stitch”) are built from .void files that you can combine across scenarios. You define small flows (auth, setup, CRUD, etc.) and stitch them together into larger workflows, without duplication. This is just the first version of this capability, we still have a lot to do here.

- Agents :The file-based, local-first model also works well with agents. Since Voiden has a built-in terminal and uses Markdown, we added “skills” so that Claude and Codex agents can work directly with .void files (using your own subscriptions).

We also published an SDK for community plugins, and made improvements to performance, reliability, and DX (keyboard-first), with careful attention to performance given the Electron base

Looking for feedback and suggestions.

Github : https://github.com/VoidenHQ/voiden

Download : https://voiden.md/download