bholmesdev/hubble.md · 언어 TypeScript(모노레포) · 라이선스 MIT · 데스크톱 버전 v0.1.23 · 별 약 1,090 · 포크 63 · 생성 2026-02-17 · 저자 Ben Holmes(@bholmesdev, Astro 코어팀))
Hubble은 "내 폴더에 쌓이는 마크다운 파일을, 사람도 AI 에이전트도 함께 편집하는 노트 앱"이다. Notion 같은 블록 에디터(/ 명령, 마크다운 단축키, 프론트매터 속성)를 쓰지만 저장 형식은 평범한 .md 텍스트다. 그래서 에이전트를 그 폴더에 붙이면 곧바로 협업이 되고, 에이전트가 노트를 고치면 Hubble이 즉시 화면을 갱신한다. 여기에 "HTML 앱"이라는 확장 개념으로, 노트 폴더를 표·책장·지도 같은 맞춤 뷰로 바꿀 수 있다.
Notion은 책(노트)을 회사 창고(클라우드 DB)에 넣어 두고, 창고 규칙(플러그인 SDK)을 통해서만 정리를 돕는다. Hubble은 책을 내 방 책장(로컬 폴더)에 그대로 두고, 사람이든 AI 도우미든 같은 책장에서 직접 책을 꺼내 고치게 한다.
도우미(에이전트)가 새 정리 도구가 필요하면? Hubble은 앱스토어를 뒤지지 않는다. 도우미에게 "이 책들 목록표 하나 만들어 줘"라고 말하면, 도우미가 그 자리에서 HTML 파일 한 장을 써넣고, 그게 곧 그 폴더 전용 미니앱이 된다.
---로 감싸 적는 YAML 메타데이터 영역. 제목·태그·날짜·완료여부 같은 "속성"을 담는다. Hubble은 이 프론트매터를 File Properties(파일 속성)의 단일 진실원으로 삼아, true/false는 체크박스로, 2026-07-30은 날짜로 자동 해석한다.Hubble이 떠오른 배경엔 "코딩 에이전트가 파일을 직접 다루는" 흐름이 있다. Claude Code·Codex·Cursor는 결국 폴더 안 파일을 읽고 쓰는 도구다. 그렇다면 노트 앱이 파일을 독점 DB에 가둘 게 아니라 그냥 폴더에 풀어 두면, 에이전트가 곧바로 1급 협업자가 된다는 게 Hubble의 통찰이다. README의 핵심 문구: "Point your agent at your notes folder to start collaborating. Hubble will live-reload as your agent edits."
두 번째 무기는 확장 방식이다. 보통 앱은 플러그인 SDK(자바스크립트 API)를 배워야 기능을 늘린다. Hubble은 "에이전트에게 HTML 앱을 짜 달라"로 대체한다. 파일시스템 자체가 확장 표면이 되는 셈이다.
| 항목 | Hubble | Notion | Obsidian |
|---|---|---|---|
| 저장 형식 | 로컬 .md + 프론트매터 | 클라우드 독점 DB | 로컬 .md |
| 편집 경험 | 블록 에디터(WYSIWYG) | 블록 에디터 | 주로 마크다운 원문 |
| 에이전트 협업 | 폴더가 곧 API · 라이브리로드 | API 있으나 파일 아님 | 파일 편집 가능(리로드 수동) |
| 확장 방식 | 에이전트가 HTML 앱 작성 | 제한적 API/통합 | JS 플러그인 SDK |
| 가격/라이선스 | 무료 · MIT 오픈소스 | 상용(부분 무료) | 무료(비오픈소스) |
맞다, 텍스트 에디터로도 .md는 연다. 어려운 건 (1) Notion급 편집 경험을 주면서도 원본을 평문으로 유지, (2) 외부(에이전트) 편집을 안전하게 실시간 반영, (3) 에이전트가 짠 임의의 HTML을 시스템을 망치지 않게 실행하는 것이다. Hubble은 마크다운↔리치텍스트 왕복 변환 엔진, chokidar 파일 감시 라이브리로드, 그리고 불투명 출처(opaque origin) 샌드박스 iframe + 토큰 인증 브로커로 이 셋을 각각 정공법으로 풀었다.
번역가와 원문의 관계. 당신은 예쁜 편집 화면(리치텍스트)에서 글을 쓰지만, 디스크에는 늘 "원문 마크다운"이 저장된다. 화면과 원문 사이를 오가는 동시통역사(remark 파서 + ProseMirror 직렬화기)가 있어, 어느 쪽에서 고쳐도 뜻이 어긋나지 않게 왕복 번역을 보장한다. 그래서 에이전트가 원문을 고쳐도, 사람이 화면에서 고쳐도 충돌 없이 같은 파일이 유지된다.
Hubble은 pnpm 워크스페이스 모노레포다(전부 TypeScript ~5.8, 린트·포맷은 ESLint+Prettier가 아니라 Biome 2.4, React Compiler까지 켜져 있음). 크게 apps/*(실행되는 3개 앱)와 packages/*(공유 코어)로 나뉜다.
electron-vite 5 + electron-builder 26 + electron-updater 6.8(자동 업데이트, 현재 macOS 한정).@tiptap/core·react·pm·starter-kit + image/list 확장) — ProseMirror 기반 블록 에디터.class-variance-authority·clsx·tailwind-merge, sonner(토스트), @iconify-json/mingcute.@tailwindcss/vite, HTML 앱엔 @tailwindcss/browser 주입).chokidar 4(파일 감시), Zod 4(검증), ignore 7(.gitignore 파싱), alpinejs 3.15(HTML 앱에 주입).astro-icon·gsap·canvas-confetti, Node 22 필요.react-router 7 + Convex 1.34(백엔드). 로컬 FS가 없으니 워크스페이스는 항상 클라우드 동기화형.unified·remark-parse·remark-gfm·mdast·yaml로 파싱, ProseMirror로 변환. Hubble의 심장.editor 위의 React UI. Tiptap 테이블, highlight.js/lowlight(코드 하이라이트), cmdk(커맨드 팔레트), @dnd-kit(드래그).global.js, html-app-theme.css)만. HTML 앱에 주입되는 에이전트 브리지.hubble 바이너리.Hubble의 도메인 모델은 CONTEXT.md의 용어집이 곧 설계도다. 핵심 개념: Workspace(.hubble/config.json이 있는 논리적 노트 묶음. 클라우드가 아니라 설정 파일의 존재로 정의됨), HTML App(폴더 안의 .html 파일을 Hubble이 실행하는 미니 UI), Embed(마크다운 안에 인라인으로 박은 HTML 앱), Workspace Snapshot(원자적으로 조립된 로딩 완료 상태 — 이게 완성돼야 화면을 그린다).