Hubble.md

익숙한 마크다운 작성 환경

Notion이나 Apple Notes와 유사한 작성 흐름을 마크다운으로 재현합니다. `/` 명령, 마크다운 단축키, 파일 속성 및 프론트매터를 지원하며, 편집 코어는 Tiptap과 마크다운 변환을 결합한 프레임워크 독립형 패키지로 구성되어 있습니다.

에이전트 협업과 실시간 동기화

에이전트가 노트 폴더를 대상으로 작업하도록 지정하면 협업을 시작할 수 있습니다. 에이전트가 파일을 수정하면 Hubble이 실시간으로 다시 불러오기(live-reload)되어, 사용자 본인과 코딩 에이전트가 동일한 노트 폴더를 공유하며 작업할 수 있습니다.

HTML 앱 및 임베드 구성

마크다운을 넘어 HTML 기반 앱을 만들고 미리 볼 수 있는 기능을 제공합니다. 별도의 Hubble 스킬을 설치한 뒤 코딩 에이전트에게 원하는 구성을 지시하면, 노트 폴더를 표, 책장, 지도 등 다양한 형태의 뷰로 전환할 수 있습니다.

설치 · 시작 · 기본 사용

데스크톱 앱은 GitHub 릴리즈 페이지에서 최신 빌드를 내려받아 설치할 수 있습니다. macOS 빌드는 서명 및 공증(notarized)이 완료된 상태이며, Windows와 Linux 빌드는 서명이 적용되지 않아 첫 실행 시 운영체제의 경고가 표시될 수 있습니다.

winget 패키지 저장소에는 `BenHolmes.Hubble.md` 패키지가 등재되어 있어 다음 명령으로 설치할 수 있습니다.

winget install --id BenHolmes.Hubble.md --exact

소스에서 직접 빌드하려면 저장소 루트에서 다음 명령을 차례로 실행합니다.

• pnpm install — 의존성 설치
• pnpm dev:desktop — 데스크톱 앱 개발 모드 실행
• pnpm bundle:desktop:mac 또는 pnpm bundle:desktop:win, pnpm bundle:desktop:linux — 운영체제별 프로덕션 데스크톱 번들 생성
• pnpm build — 검사, 전체 패키지 빌드, 타입 검사 수행
• pnpm check — Biome 실행
• pnpm typecheck — 전체 패키지 타입 검사

개발 흐름과 패키징 방식에 대한 자세한 내용은 저장소 내 `apps/desktop/README.md`에서 확인할 수 있습니다.

활용 예시

• 마크다운 단축키와 프론트매터를 활용해 개인 지식 관리 노트를 정리하고 검색합니다.
• 코딩 에이전트에게 노트 폴더를 가리키도록 지정해 사용자가 직접 작성한 내용과 에이전트가 보완한 내용을 같은 폴더 안에서 협업으로 다듬습니다.
• HTML 앱 기능을 활용해 노트 폴더를 표, 책장, 지도 등 자유로운 형태의 뷰로 구성하여 정보를 시각적으로 탐색합니다.

지원 환경 · 요구사항

운영체제는 macOS, Windows, Linux를 지원합니다. 아키텍처는 x64입니다. 소스 빌드 시 Node.js와 pnpm이 필요하며, macOS 데스크톱 빌드 추가 요구사항으로 Xcode Command Line Tools(xcode-select --install)가 있습니다.

제한 · 라이선스 · 확인사항

Hubble.md는 MIT 라이선스로 배포되며, 자세한 내용은 저장소의 `LICENSE` 파일에서 확인할 수 있습니다. macOS 외 플랫폼의 빌드는 서명이 적용되지 않아 첫 실행 시 운영체제의 경고가 나타날 수 있습니다. 저장소 내 웹 앱(apps/www)과 동기화 엔진(packages/sync)은 아직 작업이 진행 중인 상태(HEAVILY WIP)로 명시되어 있습니다.