gitwtfhub

wtf is hubble.md?

bholmesdev/hubble.md — explained in plain English

Analysis updated 2026-08-13

1,284TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A free, open-source Markdown notetaking desktop app designed to be edited by both people and AI coding agents in real time.

Mindmap

mindmap
  root((Hubble.md))
    What it does
      Markdown notetaking app
      Agent-ready live sync
      Custom HTML views
    Tech stack
      TypeScript
      Electron
      pnpm workspace
    Use cases
      Personal note-taking
      AI agent collaboration
      Custom note views
    Audience
      Note takers
      Vibe coders
      Agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Take notes in Markdown with a Notion-like writing experience on desktop.

REASON 2

Point an AI coding agent at a notes folder and watch Hubble update live as the agent edits it.

REASON 3

Build custom HTML views, like tables or maps, out of a folder of Markdown notes.

What's in the stack?

TypeScriptElectronpnpmTiptapConvex

How it stacks up

bholmesdev/hubble.mdpixel-point/avalanthropics/cwc-workshops
Stars1,2841,2821,279
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-26
MaintenanceMaintained
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Download the prebuilt desktop app, building from source needs Node.js, pnpm, and Xcode tools on macOS.

Use freely for any purpose, including commercial use, under the MIT license, as long as you keep the copyright notice.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Help me set up Hubble.md and point an AI agent at my notes folder so it live-updates as the agent edits.
Prompt 2
Walk me through installing the hubble-skills package so my coding agent can build custom HTML views of my notes.
Prompt 3
Show me how to compile Hubble from source using pnpm for macOS.

Frequently asked questions

wtf is hubble.md?

A free, open-source Markdown notetaking desktop app designed to be edited by both people and AI coding agents in real time.

What language is hubble.md written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, pnpm.

What license does hubble.md use?

Use freely for any purpose, including commercial use, under the MIT license, as long as you keep the copyright notice.

How hard is hubble.md to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is hubble.md for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.