41 comments

[ 0.21 ms ] story [ 13.2 ms ] thread
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.
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.

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

All my agents need are plain .md files in my project directories.
That's all Hubble is! You can treat it like a text editor for your existing .md files
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.

1. https://www.tldraw.com/

TIL agents can interact with tldraw documents. Thanks for sharing
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/

midwit meme, but both ends are just "a pile of .md files in a synced directory somewhere"
but how is it different from my notion?
How is this different from Obsidian? Why would someone switch? The page is a bit lacking on detail.
can we have a moratorium on notetaking apps?
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.

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/issues
I have always found markdown cumbersome. Will try this later. Seems like the main thing is having agent input right there, which is handy.
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

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.

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

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.
It's just a folder on your filesystem, no fancy cloud setup. Similar to Obsidian.
I'll be more blunt than other commenters: this is useless. Obsidian and plenty of other note taking apps already do the same and more.

Add to that the fact that it's likely entirely vibe-coded, there's really 0 value proposition here.

Cool, I needed a lightweight markdown editor. I like Obsidian but it's not really a notebook. What's missing is a ToC view for your .md as a sidebar which Obsidian has.
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.

Obsidian exists. It is more feature rich and mature.