Show HN: Voiden – a free, offline, Git-native API Client

76 kiselitza 67 5/28/2025, 12:48:43 PM voiden.md ↗
Hey HN! Aldin here, a helping hand to Voiden (https://voiden.md)

Voiden is a free, offline, Git-native API client. Your API definitions, docs, and tests all live together.

It came out of years of frustration: cloud sync lock-in, paywalled basics, bloated UIs, and lag on even simple requests. So the team built the opposite: an offline tool with no login, no telemetry, no lock-in. Just markdown and hotkeys.

It behaves like code: local files, git branches, no cloud nonsense. Terminal is built-in, so you can commit, diff, and push changes right from the app.

Docs stay close to your requests, so that API spec and what the API actually does never drift apart. No more scattered Postman, docs, and test files everywhere. A single source of truth.

A minimalist GET request looks something like this:

      GET
      https://dummyjson.com/posts
Just hit /endpoint, paste the URL, and run it with Cmd/Ctrl + Enter.

Not OSS (yet), but 100% local and free. Optional plugins will be coming down the line, but the core stays free.

We'd love feedback from folks tired of overcomplicated and bloated API tooling.

Comments (67)

cssanchez · 19h ago
This looks great. Regarding the taglines and copy being confusing for some, I understood it, but I have some suggestions:

Instead of saying what it is, say what it does (for the user). For example instead of 'Offline-first API Client'..., try "Document your API, test it, and version it using Git 100% locally and free in a modern GUI. Voiden even includes a terminal so you can execute any command or custom workflow without ever leaving the app. (OSS release coming soon)". Remember, show, dontt tell.

kiselitza · 19h ago
Much appreciate the suggestions! :)
remram · 11h ago
Looks to be similar to Hurl https://hurl.dev/ https://github.com/Orange-OpenSource/hurl Apache-2.0

Not sure, it's hard to parse your website. Too many empty taglines like "docs that do more" and "git-native", and the 5px font in your screenshots does not help. This screams "no programmers only designers here". Honestly it's a red flag for a programming tool.

kiselitza · 7h ago
You almost had me until the "5px font" line, then it just went into waffle territory.

As for the Hurl comparison: that’s like saying Hurl is the same as Bruno, Yaak, and the rest of the crew - if aiming there, sure. Voiden isn’t a themed CLI, so visually it’s not even in the same category. And functionally, the whole point is having docs, tests, and the spec all in one place. That's something CLI tools don’t really aim to solve.

Some overlap in request-sending, sure, but very different purposes.

rapnie · 1d ago
> Not OSS (yet)

Does the "yet" infer that you do intend to open source the baseline product, and then have paid plugins?

kiselitza · 1d ago
That's correct. The intention IS to open source.

Voiden evolved from an internal tool where the team bundled a lot of features into the core product. Currently separating certain things into plugins. By the time that is done, and some community adoption/engagement is happening, the tool will be open-sourced.

As per the plugins, that's right. Some of the plugins can/will be monetized - but that's the discretion of the plugin developers. We won't be charging for any plugins that we build, unless they have an operational cost for us.

leguy · 23h ago
I hold no judgement here, as someone who has only ever built software for profit but if the intention is to make it OSS, why not start that way? For many, OSS is a core feature, and as you know, many devs have been burned by postman, insomnia, etc.
kiselitza · 22h ago
To the best of my understanding, it is exactly what I wrote in the parent comment. It's the fact that the core lacks bits developed in the internal tool but not yet unglued from what will go in the plugins section.

It's not unheard of. For instance, I got another team and devtool I work with, non-related to the API niche, and they are going open source mid-next week. Some teams want to build the core their way, some want to see if it will catch traction before committing to support an entire community and contributions, some have got something else going on, some actually ARE shady and talk OSS for clout, etc.

phoronixrly · 1d ago
I'd like to put an emphasis that the biggest part of 'When Did API Tooling Become a Circus' is the idea that you can close source, lock down, and enshittify dev tools.
kiselitza · 23h ago
Oh, 100%. And I'm all for FOSS and an adapter architecture approach (no lock-ins of any kind). Team is aware of it, CTO wants it, so opening the core is happening. I've got no reason not to believe them. Ofc, can't expect a stranger to believe me either. The fact that you can build your own plugins on top of the core, even before open-sourcing it, should be a sign that it's about giving you control, not locking you in on anything. But yeah, actually making it OSS will make that trust grow much easier.
pvg · 1d ago
It would probably imply it
rapnie · 1d ago
Being open source is a feature, and I have often seen marketing imply this and when pressed returning a "we are considering it", while remaining proprietary. I have also seen "at this early stage the core is still minimal", and then staying like that for the free version.
jkcxn · 19h ago
This seems like a really good idea. I like that it's just markdown files and how seemless it is with an existing project. I have a few minor suggestions

1. I would really like a way to run the endpoint by clicking something in addition to command+enter (it wasn't obvious that I could open the sidebar and then click play but I see that now)

2. It would be good to include the evaluated request body and headers in the result sidebar

3. Duplicate file in the file tree context menu - I saw it in the tab context menu but that seems unintuitive

4. Maybe allow the user to set variables inside the markdown that can be imported to other files, for example a customerId variable that different requests could use which isn't part of the environment

5. Dragging text around appears like it will be moved but when releasing the mouse nothing happens

And finally 1 question I have: is this using an underlying text editor? It looks pretty robust but it doesn't look like VSCode, maybe something else? I am wondering if it's available to use for my own project

kiselitza · 49m ago
Much appreciate the feedback! Took it to the team already. I waited to get a confirmation for your question before answering, so here it is: it's built on top of tiptap + codemirror.
netghost · 21h ago
It seems really neat, but it's unclear what problem you're solving.

Is the goal of the project to let people write documentation for APIs, explore APIs, or something else?

Here are a few suggestions:

1. Start with a clear story of why you built this. Not lock in etc, but what were you or your team trying to do? That will help me understand whether I too try to do this thing.

2. Now you can tell me about all your frustrations, and I as a fellow misery drenched individual will say "Yes! I too have suffered the lack of cloud sync lock-in!"

3. Let me see it! Is there a way to embed the actual editor in the browser? Barring that putting a heading over the video, or a caption telling us what you're doing. When I click around to explore, let me click on those screenshots so I can see what you've built.

All in all, this looks really neat, but the challenge with building something divergent is that you need to invest more effort in telling the story.

kiselitza · 21h ago
I've been reading this one and then the post itself a couple of times. Appreciate the suggestions and the time you took to write them down. Just not sure if those would help here (not saying they 100% wouldn't). I am all for storytelling on some platforms, but HN is IMHO a no-bs, no fluff, keep-it-short and to-the-point space.

If you're a dev, and you excessively ran APIs or governed them, you most likely remembered the pains mentioned later in the post the second you came to "API client" bit. The frustration bit should tell you why it's not just another one of those tools but rather addresses those pains. And the example is showcasing the minimum effort needed to execute an endpoint.

If I were to rewrite it again, I don't think I'd change much, if anything.

netghost · 21h ago
> If you're a dev, and you excessively ran APIs or governed them…

I am a dev, and it took me a while to realize this was the pain point you were solving. Mayhaps I'm the wrong dev, and that's just fine, regardless this looks pretty neat.

kiselitza · 20h ago
Or maybe I'm the wrong storyteller for you :D We did get a couple of pieces of feedback re- the landing page not being clear. I'm wondering if you checked the website before or after reading my copy? Would you say that may have impacted this "time to realisation" span?
gschier · 23h ago
As the creator of another free/offline/git-native API client Yaak (https://yaak.app) I just want to say this looks awesome!

It's refreshing to see a new API client that isn't just a reimplementation of Postman's interface.

kiselitza · 23h ago
Hey, I know you! I used to use Insomnia before all the lock-in mess while I was still a dev. Thanks for the kind words, the team will appreciate it. I hope you keep doing what you like!
gschier · 23h ago
Hah, that's awesome to hear! That lock-in mess was a sad time for me. Let's take some of that marketshare away from Big Co
giancarlostoro · 23h ago
Wait you also made Insomnia too, that's pretty cool. Good on you to keep doing what you enjoy.
gschier · 23h ago
Yep, and thanks! For some reason companies keep thinking API clients are big business and ruin them with attempts to maximize profits.
stronglikedan · 19h ago
Well, I've been using Insomnia up until today! Didn't know about the drama. At least I have a few alternatives to try now thanks to this post.
iand675 · 1d ago
I mean this nicely, I don't really feel like anything on the landing page besides one paragraph is actually helpful to readers understanding what problem you're trying to solve.

I think it'd be useful to focus on this more:

> Voiden turns your API definitions and docs into dynamic, purpose-built interfaces — no fixed UI, no rigid templates. Everything is composed in one place and rendered down to Markdown, tailored to the API it serves.

kiselitza · 1d ago
Hmm, I appreciate this, for real. We'll have some more discussions on how to optimize the landing page.

Curious, how do you feel about the tagline stuff? Happy to learn anything else you'd be willing to add here. We're all for making it crystal clear, no fluff, just making devs lives easier, which also means not wasting their time to understand whether they need it or not.

qcic · 23h ago
Not GP, but the tagline above the fold doesn’t tell anything related to the actual value prop. Modular, extensions etc are implementation details. Git-native? I had an “idea” of what that meant, but had to scroll down to confirm.
andybak · 22h ago
I'm still not sure what an "API client" is in this context.
kiselitza · 21h ago
Not sure how else to reply to this one, but it is the same thing as in its definition. Think less of client-server, think more of Postman, but without gazillion tabs and with docs at the same place with your API endpoint definition, headers, body, etc.
lawgimenez · 21h ago
Or git-native means.
andybak · 21h ago
I just downloaded it and tried it and I still don't understand what it does.

It seems to be some kind of wysiwyg editor? With elements specific to API docs?

But then why does that make it an "API client". I'm guessing "API" specifically means HTTP API here. But "client" is completely throwing me. An API client is just software that talks to an API. So what's with the wysiwyg stuff?

Is it something like Jupyter notebooks?

kiselitza · 21h ago
The Jupyter comparison isn't completely off base if you'd like to rationalise it that way. Similarity would be blending the code and the docs in a single file, where you can then also execute something.

By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while.

andybak · 20h ago
> By definition, API Client is a devtool that makes it easier for devs (& co.) to design, test, document, and debug APIs. If it's confusing, we can take it to Postman, but it's an industry standard, been that way for a long while.

That's not the definition of "API client" I'm familiar with. In fact it feels like a very specific definition of "API client" - which is a broad term that I am familiar with.

(Why does it sometimes feel like I am not getting the memos that everyone else is getting? It's like when a new job description for an old job suddenly appears and everyone pretends that what it's always been called!)

kiselitza · 19h ago
Maybe you thought of an SDK-like client/wrapper for calling certain APIs, so it sounds natural to call it an API client? Here you can check a list of currently OSS API clients (competitors to Voiden - the tool I posted about) https://github.com/stepci/awesome-api-clients Will join the list soon after we go OSS too. :)
andybak · 3h ago
I guess "API client" is often shorthand for "API client library" but that seems less of a stretch than using it to mean "App for calling, testing and documenting an API". A quick Github search seems to indicate that the former usage is more common in any case.
kiselitza · 21h ago
It's an expression. Meaning it's not just allowing you to use some git sync workaround, but actually use it as if you would in your terminal, respecting all of its commands and conventions.
nikolasdimi · 1d ago
true
zimbatm · 21h ago
One thing I miss the most when writing Markdown is this formula experience you get in Excel. Jot something down, get the result. Then link it to another block.

There are tools like Jupyter notebooks that have all the functionalities, but their file format isn't very readable or diffable using standard terminal tools.

A while back I wrote https://github.com/zimbatm/mdsh to explore the space. Voiden.md looks like a fancier version of that.

kiselitza · 20h ago
You could technically add mdsh to the Voiden terminal, and now the whole thing is fully markdown haha. Curious, what did you learn from exploring it?
googoloid · 22h ago
This looks pretty exciting, the documentation aspect of api-client-in-md has potential!

When do you think you'll have a linux client available? I'm hoping it will be available via flatpak :)

kiselitza · 22h ago
Deb and rpm should be ready any day now. I got nothing on flatpak or appimages tho.
googoloid · 20h ago
Well, I'll be happy enough with an rpm on fedora!
kiselitza · 7h ago
Beta Linux version is up there. Feel free to check it out :)
utrack · 1d ago
Is there any way to subscribe to be notified when the Linux package becomes available?
kiselitza · 7h ago
Beta Linux version is now on the website. Feel free to go check it out :)
kiselitza · 1d ago
The easiest way I can think of is for you to join the Discord server. Top right corner of the website (I'm aware that's not the best icon for it - addressed it to the team).

Shouldn't take long until Linux is up there, tho. I know the team started managing the build process.

BewareTheYiga · 1d ago
I'm curious to give this a spin and see how it compares against Bruno (https://www.usebruno.com) --> not affiliated
kiselitza · 23h ago
And we're happy to hear your feedback about it :)
ale42 · 1d ago
Setup executable is pretty big, is it an Electron app?
kiselitza · 1d ago
Yep, it's an Electron app. Looking to optimize it as well.
the_arun · 23h ago
What do you mean by offline? Don't we need to be online if we need to make an API call?
santiagobasulto · 23h ago
Not my product, but I think "offline" means no-cloud. You keep track of your API calls / definitions in your local filesystem/Git server without storing it in someone else's server.
giancarlostoro · 23h ago
I wonder if this is the time to start pitching "Offcloud" or even "Cloud-free" or even "No-cloud" as opposed to "offline" as a feature ;)

It's nice to have the option to not need an entire online apparatus to make your software function.

kiselitza · 23h ago
Huhh, I think that may not be the worst idea. Feels like there’s room for a better shared language around this shift from everything-as-a-service towards owning your stack. Maybe even bringing back localhost is not the worst approach. Hmmm… just thinking out loud.
quinncom · 22h ago
SnaS – software, not a service.
kiselitza · 23h ago
Well, it's a standalone, non-hosted, offline application.

If you're designing your own API, you can do all the specs, docs, and if you get it up and running on localhost, you don't even need internet for testing it.

If you want to run a hosted API endpoint, or push your changes to git ofc you'll need the internet, but not because of the application, rather because you're trying to access something else that is not offline.

andybak · 22h ago
OK. That's confusing.
qcic · 23h ago
No. You can very much call your project that is running locally without any internet connection.
GlacierFox · 1d ago
This actually looks great. Can't wait to try it out when I get home.
kiselitza · 1d ago
Much appreciated :) Let me know how it feels, the goods and the bads, every bit of feedback is very welcome.
popalchemist · 18h ago
Is the app itself not FOSS?
kiselitza · 17h ago
Atm just an F, catching up with the rest of the letters. :)
rohitghumare · 1d ago
Something I was looking for.
kiselitza · 1d ago
Sweet, let us know how it feels. Happy to hear the feedback
nikolasdimi · 1d ago
cool!
_nhh · 1d ago
if its offline, how do you clone a repo? :thinking:
kiselitza · 1d ago
A repo, as in the project that contains the API specs and definitions, which you and your team are working on? Through terminal `git pull`

Or you're asking me something else?