Join the discussion
Write your take first — we'll ask for email only when you're ready to publish.
- Hacker News
- Thanks for sharing this handfuloflight! This is Ben, creator of Hubble. I've been replying to comments throughout this post (appreciate the thorough feedback). If you have any questions for me, fire away.by bholmesdev
- I also have one I developed according to my use: https://github.com/egeozcan/mahpastes
It has a rest api and a cli tool, and also the possibility to make headless deployments, and it can sync clips without a sync server. It can serve folders/tags and optionally expose a read or read/write api for JSON files on the same level. It supports lua plugins, and I have a fal.ai plugin to generate/edit images already in the repo (some other examples there).
It has a lot of features so maybe it's better if I just link to the docs: https://egeozcan.github.io/mahpastes/
by egeozcan - What are your thoughts on Hubble?by losteric
- I think that is a really nice implementation. A few questions:
Can you easily share lists or pages or is it all local? (Is there a cloud element to it)
What are the most useful examples you’ve personally found when it comes to using the HYML component?
I built https://smalldocs.org for my agent’s Markdown needs. I extended it so it can render complex formats: Mermaid diagrams, charts, in-document slides and even in-document spreadsheets. It gives your agent a good selection of formats to express itself as it helps you understand whatever topic you’re looking into.
Here is a sample document: https://smalldocs.org/blogs/what-is-a-smalldoc
I publish anonymous analytics here: https://smalldocs.org/analytics
by FailMore - Please stop spamming your project.by yencabulator
- Looks interesting. The dual interface from the start (React UI for humans and just editing .md for the agents with skills) is an interesting idea and probably how a lot of new software projects will work going forward
I feel like tables are generally underrated while the AI ecosystem is focused on .md files but I guess markdown has tables so they’re included to some extent
by firasd - The current sepia color scheme you see on all vibecoded websites is so, so tiring.
And before you ask, the next "trend" will be as much tiring.
by monegator - All my agents need are plain .md files in my project directories.by ernsheong
- That's all Hubble is! You can treat it like a text editor for your existing .md filesby bholmesdev
- it's interesting -- i think most (non-technical) people don't really have a muscle memory go-to markdown editor. i certainly didn't. i hated obsidian at first! funny how learning to like markdown makes obsidian like 1000x better hahaby 0gs
- There are also a lot of mcp agents for Joplin: https://discourse.joplinapp.org/t/ai-agents-and-joplin/46168 Dare I say, another, more popular, note taking app for you and your agents.
I really like it as I run a webdav service and can read/write and sync notes between multiple Mac desktops and Android. Encrypted while I am at it.
Markdown native.
by mianos - But does joblin support anything more than markdown? I'm thinking of using it as a like a store for agent plans, so I can easily edit stuff. Can an agent add rendered HTML, meramaid etc in joblin?by fariszr
- I’ve been waiting for an app like this to be developed! .md files can be opened from Finder! The tree file view is just like I’m used to with Obsidian! Frontmatter support! There’s even an editor toolbar. Almost everything on my wishlist for a Markdown editor, except for Mermaid rendering.
Since this project uses such good agentic engineering practices, I was able to use Claude Code to add support for Mermaid diagram rendering and produce my very own local build on Mac, all in about 30 minutes.
Thank you! Hubble+cmux gets me close to the agentic IDE I’m working towards.
by shreddude - Thanks, glad you like it! Feel free to start an issue and a prototype PR for mermaid diagramming support. It's been on my todos to add: github.com/bholmesdev/hubble.md/issuesby bholmesdev
- Seems odd that you wouldn't comment on the existing issue, or open a PR?by e12e
- If you don't mind me asking, what are "good agentic engineering practices"? To my knowledge, we are still exploring many techniques of using agents within a codebase, and have not widely agreed on "best practice".
Do you mean "good code" and "good documentation"?
by nerptastic - You seems pretty enthusiastic about this very new and not very well known software...by darkwater
- I'm trying to understand why this can't just be a folder on your disk. Agents know how to use "ls" and "cat" so I guess I'm missing something.by dewey
- It's just a folder on your filesystem, no fancy cloud setup. Similar to Obsidian.by bholmesdev
- You’re not, thing that makes it agent friendly is copy path buttonby rpunkfu
- Will check this out too.
Now, I'm having fun with tldraw.[1] With their new tldraw offline, I can continue to work in Claude Code (and others) and I can either output or interact/input from tldraw. This is more of a free-form, infinite canvas. I treat it like Excalidraw + Draw.io + Freeform Notetaker.
For text, most agents/LLM/assistants are pretty happy and smart using the same Markdown files to anywhere I have allowed them to interact.
by Brajeshwar - TIL agents can interact with tldraw documents. Thanks for sharingby bholmesdev
- I feel like there's not enough content on the landing page to help me understand why I need yet another notetaking app. The burden of proof is high given how many of these there are.by flippyhead
- Also why is it a nodejs app? With the explosion of LLM and the insane increase in productivity shouldn't it be a Rust app?
- At least it is self describing, unlike some other projects that are like "An alternative to faomz with deliric integration"by braiamp
- Good feedback, I'd like to add more sections to the homepage to describe the components / motivations more clearly. The scope has increased to more agent collaboration features this past month too. Here's the reasons I shared elsewhere here:
- I wanted something closer to Apple Notes or Notion for simpler editing. Hyperlinks are popups instead of in-line strings. Formatting is WYSIWYG, without *_ characters in-line. There's a / menu to discover formatting options. etc.
- I wanted an app that could display HTML pages alongside Markdown. And more interestingly, I wanted to give those HTML pages access to Markdown files in the folder, using Markdown as a mini-database to build apps on top of. This is likely possible with Obsidian plugins (everything is) but I wanted something first-class. The hubble.md homepage tries to communicate this, but I could likely do a better job :)
- More recently, I've wanted markdown -> agent handoff to be better. We've added an embedded terminal to chat with agents alongside notes directly, and we've just added a first-party commenting system similar to commenting in a Google doc (agent accessible with in-file metadata). All of these features have been community-led. I'm very grateful for our repeat contributors.
by bholmesdev - Genuinely curious, maybe I'm missing something. What makes this more "agent-ready" than Obsidian .md files on disk or even something like .org files?
I can let my agent edit those files all the same + there's better integrations and knowledge readily available on these.
I can tell my agent to edit the Obsidian Markdown just like that, but I can also tell it to create a full-on notebook with backlinks and DataView queries. I can tell my agent to create logically complex .org notes with code blocks and references.
To me, Hubble just seems like a Markdown editor, based on the premise that agents are able to edit local files.
by xn--yt9h - Usually, I have vscode/Claude Cowork up on one side and on the other is Obsidian. I made a plugin[1] that converts emails to `.md` so they can also be in Obsidian folder -- so Claude can query those emails the same way it does my notes. Works beautifully.by chaidhat
- Fair comment. Hubble and Obsidian both use Markdown on-disk, so they're equally agent-friendly.
There's a few reasons I built it instead of continuing to use Obsidian (which I've used for years):
- I wanted something closer to Apple Notes or Notion for simpler editing. Hyperlinks are popups instead of in-line strings. Formatting is WYSIWYG, without *_ characters in-line. There's a / menu to discover formatting options. etc.
- I wanted an app that could display HTML pages alongside Markdown. And more interestingly, I wanted to give those HTML pages access to Markdown files in the folder, using Markdown as a mini-database to build apps on top of. This is likely possible with Obsidian plugins (everything is) but I wanted something first-class. The hubble.md homepage tries to communicate this, but I could likely do a better job :)
- More recently, I've wanted markdown -> agent handoff to be better. We've added an embedded terminal to chat with agents alongside notes directly, and we've just added a first-party commenting system similar to commenting in a Google doc (agent accessible with in-file metadata). All of these features have been community-led. I'm very grateful for our repeat contributors.
If any of that sounds interesting, give it a try! Otherwise, feel free to give feedback on the app itself or the homepage on GitHub. All of that is open-source: https://github.com/bholmesdev/hubble.md
by bholmesdev