AI Native를 위한Markdown Note
AI가 가장 잘 읽고 가장 잘 이해하는 형식 — 순수 마크다운으로 모든 노트를 저장합니다. 음성메모, 메신저 메시지, 회의 기록, 떠오른 아이디어까지 하나의 파일 트리에 쌓여 당신만의 지식 베이스가 됩니다.
AI가 가장 잘 이해하는 언어,
마크다운
Claude, GPT, Gemini — 모든 최신 LLM이 학습 단계에서 가장 많이 본 구조화 포맷은 마크다운입니다. 제목·목록·코드블록·링크가 그대로 의미로 전달됩니다. Cosmica는 어떤 입력이든 결국 .md 파일로 남겨, 당신의 생각이 모델에게 바로 읽히는 포맷으로 축적되게 합니다.
## 음성메모 요약 — 2026-04-14 09:32
**원문**
> 클린 아키텍처의 의존성 역전을
> Cosmica 설계에 적용하면…
**요약**
- 도메인 레이어는 외부를 모른다
- 어댑터를 통해서만 통신
- 파일 I/O는 포트 인터페이스로 추상화
**태그**
#AI #Cosmica
**관련 노트**
[[Cosmica-design]] [[AI-ideas]]노트와 AI가 처음부터 한 몸
Obsidian의 파일 주권, Notion의 매끈한 에디터, Claude의 추론 — 필요한 건 모두, 강요는 없이.
음성메모 → 노트
녹음하면 Whisper STT + AI 요약 + 태그 추출이 자동으로 마크다운에 기록됩니다.
마크다운 에디터
Milkdown 기반 WYSIWYG + CodeMirror 소스 모드. 파일이 원본이라 외부 에디터와 충돌 없이 공유됩니다.
로컬 내 AI 연동
이미 설치된 Claude Code · Codex CLI를 자동 감지하고, 필요하면 Anthropic API로도 붙습니다. 새 구독 없이 지금 쓰던 AI 환경을 그대로 씁니다.
지식 그래프
백링크 그래프 · 태그 그래프 두 뷰. D3 force-directed로 500 노드까지 탐색합니다.
전문 검색 (⌘K)
SQLite FTS5 기반. 태그·폴더·소스 필터와 커맨드 팔레트(⇧⌘K)까지.
메신저 봇 수집
Slack · Telegram · Discord로 보낸 메시지가 노트로 자동 기록되고, 노트를 채널로 보낼 수도 있습니다.
NotebookLM 연동
MCP 기반 업로드. 원본 또는 AI 요약 모드, 태그 묶음 일괄 내보내기 지원.
기기 간 동기화
Google Drive 또는 GitHub 저장소(gh CLI)로 여러 기기에서 같은 노트 트리를 공유합니다.
모바일 브릿지
QR 한 번이면 같은 Wi-Fi나 Tailscale 안에서 폰이 데스크탑에 직결돼, 데스크탑에 설치된 Claude CLI를 모바일에서 그대로 호출합니다.
캔버스 · 캘린더
화이트보드와 생성일/수정일 기반 캘린더 뷰.
말하는 대로 기록되고,
요약까지 끝난다
녹음 → STT → AI 요약 → 태그 추출 → 마크다운 저장. 한 번의 클릭으로 전체 파이프라인이 흐릅니다. 원문 텍스트는 항상 보존되고, 추출된 태그는 언제든 수정할 수 있습니다.
- Whisper.cpp · Web Speech API기본은 Web Speech API, 오프라인과 정확도가 필요하면 로컬 Whisper로 전환.
- 요약 프롬프트 커스터마이즈템플릿을 프로젝트 맥락에 맞게 수정해 팀/개인 스타일을 반영합니다.
- 자동 저장 옵션5초 프리뷰 후 자동 저장. 원본 음성은 ~/CosmicaNotes/Voice 에 WebM으로 보관.
파일이 원본이다.
에디터는 거들 뿐.
Milkdown 기반 WYSIWYG 에디터지만, 저장되는 건 평범한 마크다운 파일입니다. VS Code, Obsidian, 다른 어떤 편집기에서 열어도 동일하게 동작합니다.
- [[백링크]] 자동 완성대괄호 두 번이면 노트 링크가 열립니다. 저장 시 인덱스가 갱신돼 그래프에 반영.
- #태그 인식본문 안의 태그를 자동 추출하고, 사이드바 · 그래프 · 내보내기가 즉시 동기화.
- 폴더 드래그앤드롭사이드바 폴더 트리에서 노트를 끌어 이동. 모든 변화는 실제 파일 시스템 기준.
Cosmica 설계 노트
마크다운 파일이 원본(source of truth)이고 DB는 보조로만 쓰인다. AI가 바로 읽을 수 있는 포맷으로 쌓는 것이 핵심 원칙이다.
[[음성메모-20260414]] 와 같은 백링크 문법은 자동 완성되며, 저장 시 태그 인덱스가 갱신된다.
- Milkdown WYSIWYG + 마크다운 호환
- #태그 인식 → 그래프 뷰로 전파
- Claude CLI에 그대로 컨텍스트로 주입
태그와 백링크로 엮이는
나만의 별자리
D3 force-directed 그래프로 노트 간 관계를 한눈에 봅니다. 노드 크기는 연결 수에 비례하고, 태그별로 색상이 묶입니다.
- 태그 필터특정 태그만 남겨 탐색 범위를 좁힙니다.
- 클릭해서 바로 열기노드를 클릭하면 해당 노트로 즉시 이동합니다.
- 증분 인덱싱노트 저장 시에만 인덱스가 갱신되어 수천 개 노트에도 가볍게 동작합니다.
노트는 언제나
당신의 드라이브 에서만 움직인다
Cosmica에는 계정도, 중계 서버도 없습니다. 동기화는 당신의 Google Drive 또는 GitHub 저장소를 통해서만 일어납니다. 데스크탑과 노트북, 작업실과 집 — 같은 마크다운 트리가 당신이 직접 통제하는 클라우드 안에서만 흐릅니다.
- Google Drive · GitHub RepoGoogle OAuth 기반 Drive API, 또는 gh CLI로 인증된 GitHub 저장소 중 편한 쪽을 고릅니다. 같은 규칙으로 다중 기기 동기화가 동작합니다.
- GitHub 저장소 자동 셋업gh CLI로 본인 저장소 목록을 드롭다운에서 골라 연결. 비어있으면 README와 동기화 마커를 자동 커밋해 초기화하고, 다른 프로젝트 저장소는 안전하게 거절합니다.
- 대상 선택 동기화마크다운 · 첨부 · 오디오를 각각 ON/OFF. 음성 원본은 로컬에만 두고 메타만 동기화도 가능.
- MD5 증분 + 충돌 보존변경분만 전송하고, 양쪽이 동시에 바뀌었으면 양쪽 사본을 남겨 수동으로 병합할 수 있게 합니다.
기기 간 동기화
Google Drive · GitHub Repo · 중계 서버 없음
- Cosmica-설계.mdGoogle Drive
- 음성메모-20260414.mdGitHub Repo
- Attachments/2026-04/diagram.pngGoogle Drive
이미 설치된 Claude Code를
그대로 쓴다
앱을 실행하면 시스템에서 Claude Code CLI, Codex CLI를 자동 감지합니다. 새 API 키도, 별도 구독도 필요 없습니다. 출력은 SSE로 실시간 스트리밍되어 노트에 바로 쌓입니다.
- CLI 자동 감지 + 우선순위 설정Claude → Codex → API 순으로 폴백. 설정에서 변경 가능.
- 5가지 AI 액션요약 · 태그 추천 · 관련 노트 · 아이디어 확장 · Q&A 생성.
- 토큰 절약형 인덱스전체 본문이 아닌 제목+태그+첫 200자만 전달해 비용/지연을 최소화.
Cosmica는 로컬 Claude CLI를 백엔드로 삼아 클라우드 의존 없는 AI 노트 환경을 제공한다.
파일 시스템이 원본이고 DB는 보조 — 외부 에디터와 데이터를 공유할 수 있다.
태그·백링크 인덱스는 저장 시에만 증분 갱신되어 규모에 관계없이 빠르다.
모바일에서도,
데스크탑의 Claude 를 그대로
QR 한 번이면 같은 Wi-Fi나 Tailscale 안에서 모바일이 데스크탑에 직결됩니다. 새 구독도, 클라우드 중계도 없습니다. AI 호출은 데스크탑에 설치된 Claude CLI를 그대로 쓰고, 노트도 당신의 두 기기 사이에서만 오갑니다.
- 1회용 60초 페어링 코드QR은 256비트 bearer 토큰을 발급받는 용도로만 한 번 쓰이고 즉시 폐기됩니다. 스샷 찍혀도 재사용 불가.
- Tailscale · LAN 자동 감지CGNAT(100.64/10) · RFC1918 · link-local을 모두 감지해 가능한 경로로 붙습니다. 외부 서버를 거치지 않습니다.
- 모바일에서 데스크탑 AI폰에서 요약·태그·관련 노트 액션을 실행하면 데스크탑의 Claude Code가 받아서 처리하고 SSE로 스트리밍합니다.
모바일 연동
QR 스캔 → 데스크탑에 직결
- Tailscale100.101.42.7 · CGNAT
- LAN192.168.1.24 · en0
- iPhone (Ray)Tailscale · 방금
- iPadLAN · Wi-Fi · 3시간 전
수천 개의 노트에서도,
⌘K 한 번이면 된다
MiniSearch 기반 전문 검색 엔진으로 10,000개 노트에서도 100ms 이내 응답을 목표로 합니다. 키워드로 부족하면 AI 시맨틱 검색이 맥락을 이해해 관련 노트를 찾아줍니다.
- 태그 · 폴더 · 소스 필터#AI folder:개발 source:voice 같은 복합 쿼리를 지원합니다.
- n-gram 한국어 토크나이저형태소 분석 없이도 한글 부분 일치가 자연스럽게 동작합니다.
- AI 시맨틱 백업결과가 부족하면 Claude CLI로 의미 기반 검색을 자동 제안.
- Cosmica-설계#아키텍처…레이어 분리와 의존성 방향…
- AI-활용-아이디어#AI…도메인 로직에 AI 추론을…
- 주간회고-2026-04#회고…이번 주 리팩터링에서 배운…
이동 중에 보낸 메시지도
같은 노트 에 쌓인다
Slack, Telegram, Discord 봇으로 보낸 메시지를 Cosmica가 자동 수신해 노트로 기록합니다. 첨부 파일과 이미지는 ~/CosmicaNotes/Attachments에 날짜별로 정리됩니다.
- Webhook 또는 Polling로컬 환경에서도 쓸 수 있도록 기본은 폴링 모드.
- 개별 / 일별 통합 노트메시지당 파일 또는 하루 단위 누적 기록 — 설정에서 선택.
- 자동 요약 옵션수신 즉시 AI 요약 + 태그 추출까지 실행해 정리된 상태로 저장.
봇 수집 · Inbox
Telegram · Slack · Discord에서 수신
- Telegram오늘 09:15
지하철에서 떠오른 아이디어: Cosmica에 주간 리뷰 프롬프트 자동화 추가
#아이디어#TODO - Slack오늘 11:02
회의 중 메모 — AI 요약 정확도가 낮을 때 fallback 경로 필요
#회의#AI - Discord어제 22:41
스레드에서 언급된 링크 저장 (첨부 3개)
#레퍼런스
NotebookLM에
바로 업로드 할 준비
특정 태그로 묶인 노트들을 하나의 마크다운으로 병합하고, NotebookLM 제한에 맞춰 200,000자 단위로 자동 분할합니다. 노트 경계에서만 잘려 맥락이 깨지지 않습니다.
- 태그 단위 병합#AI, #아키텍처 등 원하는 태그를 선택해 묶음을 구성.
- 노트 단위 분할노트 중간에서 잘리지 않도록 자연 경계에서만 파일을 나눕니다.
- 마크다운/PDF 내보내기공유·백업 용도로도 동일한 내보내기 파이프라인을 재사용.
NotebookLM 내보내기
태그별로 묶어 200,000자 단위로 분할
- AI_notes_01.md200,000자
- AI_notes_02.md112,480자
당신의 생각은,
당신의 디스크에 있습니다
가입도, Cosmica 계정도 없습니다. 원본은 언제나 당신의 홈 디렉터리 안 마크다운 파일. 동기화는 켤 때만 켜고, 그때도 데이터는 당신의 Google Drive 또는 GitHub 저장소에만 머뭅니다.
~/CosmicaNotes/ ├── Note/ │ ├── dev/ │ │ ├── Cosmica-design.md │ │ └── voice-memo-20260414.md │ ├── ideas.md │ └── inbox/ │ └── inbox-20260414.md ├── Audio/ ├── Attachments/ ├── Canvas/ └── .trash/ ~/.cosmica/ ├── config.json ├── cosmica.db └── whisper/
지금, 당신의 노트를
별자리로 잇기
macOS Apple Silicon 빌드를 제공합니다. 설치 후 첫 실행이면 충분합니다 — 계정도, 설정도 필요하지 않습니다.