bholmesdev/hubble.md

Hubble.md is a free, open source notetaking desktop app built around plain Markdown and HTML files. It aims to give people a writing experience similar to Notion or Apple Notes, but stored as ordinary Markdown, with slash commands, Markdown shortcuts, and support for file properties or frontmatter. What sets Hubble apart is that it is designed to work alongside AI coding agents as well as people. A user can point an agent at their notes folder and Hubble will update live as the agent edits the files, so notes and automated changes stay in sync. Beyond plain text notes, Hubble also lets users build custom views of their notes using HTML based apps: by installing a separate set of skills and telling a coding agent what to build, a folder of Markdown notes can become a table, a bookshelf display, a map, or other custom layouts. Hubble ships as a downloadable desktop app for macOS, Windows, and Linux, available from the project's releases page. The macOS build is signed and notarized, while the Windows and Linux builds are unsigned, so those operating systems may show a warning on first launch. For anyone who wants to build the app directly from source, the repository is organized as a workspace using the pnpm package manager, requiring Node.js and pnpm as prerequisites, with additional Xcode command line tools needed for macOS builds. The codebase is split into an Electron based desktop app, a marketing website, an in progress browser version, and several shared packages covering the Markdown editor core, shared UI components, a filesystem sync engine, and a command line tool for syncing a notes folder from the terminal. The project's own issue triage, draft implementations, and code review are handled by an automated agent system called Warp Factory agents, with every agent contribution clearly labeled so it is obvious what a person wrote versus what an agent produced. Hubble.md is released under the MIT license, and the project welcomes outside contributions, asking contributors to open an issue before starting substantial work.