LIVE
Loading live headlines…
Home Trending World Technology Entertainment Gaming Sports Music Science Lifestyle Business About Contact
c/foss by u/nikolasdimi 1d ago lemmy.world

Built an offline API tool with plain text files all the way down , inspired by curl and obsidian.

12 upvotes 0 comments
I am a member of a + 30 people team and most API clients we used felt like they were built for a different job than what we actually did (testing endpoints, maintaining API docs and making sure that new versions of the API matches with out docs). Our team lives in Git, and our docs always drift away from the actual requests inside Postman. The fear I kept hearing when discussing with the team and other devs was "I don't need another bloated API tool".

So we built and open sourced Voiden a few months ago: an offline API tool where requests live as executable markdown and are versioned in Git.

The original idea and inspiration is to combine the flexibility of Obsidian-style files with the simplicity of curl. The result is a tool in which everything can be composed with blocks (endpoint, auth, params, body) that can be added, reused, overridden, and stitched together across executable markdown files.

**Results so far:** Since open sourcing, we got +12K installs, +1K stars on guthub plus a lot of feedback and contributions.

**What it does today:**

- REST, GraphQL, gRPC, WebSockets (as plugins, install only what you need)
- Ability to compose Requests with API blocks. Reuse, Replace & Version everything just like code.
- Postman and OpenAPI import so you don't redo years of work
Built-in terminal
- Pre/post request scripting in JS, Python or Shell
- A batch runner for chaining .void files with env selection and stop-on-failure
- Agent-friendly CLI, works with Claude and Codex skills
- We have also a few features in early access, such as the (much anticipated) CLI runner
+more

Looking for feedback and ideas from anyone interested.

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

Download: https://voiden.md/download

![](https://lemmy.world/pictrs/image/f8ed4e46-cfb0-45ad-811a-350973974205.png)
Visit source Open discussion