Runnable Markdown notes for developers and DevOps. Run a code block in place and its output streams in beneath it. Free and open source, for Mac, Linux, Windows, iPhone, and Android.

74 points•dancablam•1 day ago•40 comments•
Hi HN,

Ledge is a Markdown notebook that runs shell commands, code, SQL, etc from inside your own notes.

I built Ledge because I spend much of my day copy/pasting commands from my notes into the terminal. I was inspired by how much cmux helped me organize my terminals - but there was still a split brain between my notes and frequently run commands. I've been daily-driving it for the past few weeks and use it for deploys, API calls, smoke tests, etc.

Ledge runs your real shell just like a terminal app and can be hosted locally or remotely over SSH using ledge-server. I've been building it since July and have recently added support for all the major platforms: Mac (Silicon), Windows (WSL required), Linux, iOS, Android. Mobile devices require SSH access to a ledge-server and Android is still in beta and looking for beta testers (see link on website)!

It's built on Bun and Electrobun and is free and open-source. Feel free to review the code and contribute at https://github.com/ledgesh/ledge

Feedback is very much welcome. Any must-have features that are missing?

40 comments

TheGoodBarnabout 7 hours ago
This is awesome I will definitely play around with it. Fits the niche gap as a standalone app vs something like [Observable Framework](https://observablehq.github.io/framework/) for data analytical type things.

I wish Notion could just integrate these things together and make it work, or someone build an Obsidian plugin. More often than not it would be so convenient to do something like this.

dancablamabout 6 hours ago
Awesome! Let me know how it goes.
olexsmirabout 4 hours ago
Really love the project, it reminds me of a now dead xiki[1]

[1]: https://www.youtube.com/watch?v=YufgfbUgEgI and xiki.org

drayfieldabout 6 hours ago
I went to look at Atuin Desktop to see what the crossover was with this product, and it's fascinating to see that the repo was archived the day this was posted here!

https://github.com/atuinsh/desktop

dancablamabout 5 hours ago
Woah. I have no affiliation with Atuin so a coincidence I'm sure but really weird.
RationPhantomsabout 4 hours ago
Kind of not surprised with the domination of Claude Code/Codex out there.
baranguneyselabout 15 hours ago
Very cool! I launched something similar as well. My idea was to create a working document in which people could develop their own tools and agents. Conversations with coding agents are treated as editable, executable documents. Both the person and the agent can write on the same page. Rather than correcting a mistake in a follow-up, you can rewrite it, delete a detour, or edit and re-run an earlier prompt. The file is always readable Markdown. Check out: https://piary.dev/

Feel free to get in touch if you are open to an exchange, you can find my contact details in the write-up.

dancablamabout 13 hours ago
Nice! I'll take a look.
theCodeStigabout 6 hours ago
As an Emacs user for over a decade I think this is brilliant, it solves my biggest gripes with org-babel which prevent me from using it in a team setting. Ledge is a lot like org-babel from Emacs, but for muggles: a familiar UI, and common format go a long way.
imglorpabout 6 hours ago
I wonder what would org-babel for team settings look like? Disk/interchange format seems less interesting than what gets shipped around and what the UX feels like.
dancablamabout 6 hours ago
Hey thanks! This gives me the motivation to keep on evolving this project :)

Read the full thread on Hacker News →

Related stories