Agent가 머무는
에디터.

<workspace>/.solomd/agents/*.yml의 YAML 파일. 한 파일 = 한 agent 작업. 필수 필드: name, trigger (schedule | on-save | on-commit | on-tag-add | manual), prompt. 선택: schedule (cron), match (glob), allow-write, write-cap, provider, model, tools 허용 목록. 설정 → Recipes → 쿡북 둘러보기에 11개 스타터 제공 —— 설치, 편집, 실행. 전체 schema는 docs/agents.md.

각 Recipe 실행은 main에서 분기: agent/<recipe>/<run-id>. 쓰기는 그 브랜치에만 착지. 성공하면 검토 대기 진입 —— diff를 검토한 뒤 승인 (main에 fast-forward) 또는 거부 (브랜치 완전 삭제). 거부된 실행은 기록에 흔적 없음. 쓰기는 실행당 cap (기본 5, 하드 상한 50) 부과 —— cap이 5인데 100 파일에 쓰려는 모델은 6번째 호출에서 거부, 반쪽 적용 상태 없음.

Cursor와 Copilot은 키스트로크 수준 코드 보완에 강합니다. SoloMD agent는 세 가지로 다릅니다: (1) 작업 단위는 *vault*, 커서가 아님 —— agent는 wikilink, backlinks, 전문/태그 검색으로 노트를 가로지름; (2) 쓰기는 일괄 + 검토 가능, 인라인 승인하는 고스트 텍스트가 아님; (3) agent는 키보드 앞에 없을 때 스케줄로 실행 가능 (주간 리뷰, 일일 요약, 태그별 트리아지). Cursor의 Agent / Composer 모드에 더 가까우며 명시적으로 작문 스타일 자동완성이 아님 (고스트 텍스트가 작가의 목소리를 묽게 한다고 믿습니다).

Recipe가 클라우드 Provider를 지정한 경우만. provider: ollama (또는 local 별칭)는 키 불필요 —— qwen2.5:1.5b가 본인 머신에서 무료로 동작. provider: claude / openai / gemini / 등은 설정 → AI에서 그 Provider 키가 필요 (BYOK). 첫 실행 마법사가 어느 경로든 안내합니다.

grep은 문자를 매치; 시맨틱 검색은 의미를 매치. "deployment"를 검색하면 "rolling out", "shipping", "release"에 대한 단락도 떠오릅니다. embedder는 완전히 Rust 프로세스에서 동작 —— 모델 파일 다운로드 없음, 네트워크 호출 없음, 클라우드 없음. 기본 꺼짐; 설정에서 옵트인. 인덱스는 <workspace>/.solomd/embeddings.sqlite (자동 gitignore).

예. SoloMD는 MIT 라이선스 오픈 소스 소프트웨어. 유료 등급, 계정, 기본 텔레메트리, 광고 없음. 작성에 도움이 된다면 개발자를 후원할 수 있지만 강제는 아닙니다.

OS 키체인 —— macOS는 Apple Keychain, Windows는 Credential Manager, Linux는 libsecret. localStorage에도, SoloMD가 쓰는 설정 파일에도 들어가지 않습니다. AI 요청은 본인 머신에서 선택한 Provider로 직접 가며, SoloMD는 어떤 모델도 호스팅하지 않고 어떤 트래픽도 중계하지 않습니다.

플랫폼에 따라 약 10–15 MB. Typora보다 약 6배 작고 Obsidian보다 약 7배 작습니다 —— SoloMD가 Tauri (시스템 webview + Rust)를 사용하고 Chromium을 번들링하지 않기 때문.

네, 완전히. 에디터 자체는 네트워크 요청을 0번 합니다. 시맨틱 검색은 로컬 전용. AutoGit은 로컬 저장소에 커밋하고 자동 push 안 함. 외부 트래픽은 (1) 시작 시 선택적 GitHub 릴리스 업데이트 확인 (설정에서 끔) 및 (2) 명시적으로 트리거한 AI 다시쓰기 호출 (선택한 Provider로 직행)뿐입니다.

단일 1.5 MB sidecar 바이너리 (solomd-mcp)가 stdio로 Model Context Protocol을 말합니다 —— 네트워크 포트 없음. Claude Desktop, Cursor 또는 어떤 MCP 클라이언트도 워크스페이스로 가리키면 8개 읽기 도구 (list_notes, read_note, search, get_backlinks, list_tags, get_outline 등)와 --allow-write 뒤에 게이트된 2개 쓰기 도구를 얻습니다. Path-traversal 가드, 워크스페이스 canonical 봉쇄.

SoloMD는 파일을 열 때 chardetng Rust crate로 자동 인코딩 감지. UTF-8, UTF-16 LE/BE (BOM 있음/없음), GBK, GB18030, Big5, Shift_JIS 등 다수 인식 및 올바르게 표시.

아직은 아닙니다 —— 내장 CRDT 동기화는 v3 로드맵. 지금 SoloMD는 iCloud Drive, Dropbox, OneDrive, Syncthing 또는 폴더 기반 동기화 도구와 완벽하게 작동. 동기화된 폴더 안에 노트를 저장하기만 하면 됩니다. 또는 AutoGit + GitHub 수동 push 사용.

SoloMD는 의도적으로 플러그인 시스템을 생략 —— 가볍고 안정적이며 감사하기 쉽게 유지하기 위해. 진지한 작가가 요청하는 기능 —— 시맨틱 검색, 버전 기록, AI 다시쓰기, 이미지 붙여넣기, KaTeX, Mermaid, 집중 모드, 사용자 지정 CSS —— 모두 core에 출시.

SoloMD는 아직 Microsoft SmartScreen 평판이 쌓이지 않은 작은 오픈 소스 프로젝트. "추가 정보 → 실행"을 한 번 클릭하면 다시 묻지 않습니다. 코드 서명 인증서를 작업 중입니다.

.md 파일을 우클릭 → 연결 프로그램 → SoloMD → "항상 이 앱 사용" 체크. 동봉된 인스톨러는 .md / .markdown / .mdown / .mkd / .txt 확장자의 핸들러로 SoloMD를 등록합니다.

Obsidian은 vault, wiki link, backlinks, 그래프 뷰, 플러그인 마켓플레이스가 있는 지식 관리 도구. SoloMD는 Markdown 파일을 쓰기 위한 가벼운 에디터 —— 하지만 Obsidian이 기본 제공하지 않는 일부를 출시 (core의 시맨틱 검색, AutoGit, MCP 서버, 한 패널의 14개 AI Provider). 플러그인 마켓플레이스 있는 두 번째 뇌를 원하면 Obsidian, 플러그인 세금 없는 작성 도구를 원하면 SoloMD.