MORI · 나의 지식정원 (Mac v1)
Electron + React + TypeScript로 만든 로컬 우선 개인 위키입니다.
계획서와 개발 기록
실행
Codex·Claude 연결 스킬: MORI 앱 DMG에는 연결 스킬 원본도 포함되어 있습니다. 앱 설정의 Codex·Claude 스킬 설치를 누르면 각 도구의 개인 스킬 폴더에 설치합니다. 수동 설치가 필요하면 저장소 루트의 skills/mori-context를 아래처럼 복사합니다. 설치 후 새 세션을 시작하면 $mori-context(Codex) 또는 /mori-context(Claude Code)로 사용할 수 있습니다.
mkdir -p ~/.agents/skills ~/.claude/skills
cp -R skills/mori-context ~/.agents/skills/mori-context
cp -R skills/mori-context ~/.claude/skills/mori-context
연결 스킬은 MORI 보관함을 로컬에서 검색·읽고, 코드 기반 문서 초안을 승인 후 새 메모로 저장합니다. 앱이 실행 중이지 않아도 되며, 앱이 열려 있으면 0.9.0부터 저장한 메모가 바로 목록에 나타납니다. 현재 메모 수정·삭제와 임베딩 검색은 지원하지 않습니다. 자세한 계약과 MSA 흐름은 MORI 연결 스킬 설치·사용법을 참고하세요.
Apple 메모 연동: 상단 Apple 메모 연동 또는 첫 메모 화면의 Apple 메모 가져오기 → 목록 읽기 → 폴더/개별 메모 선택 → 가져오기. 이후 연동한 모든 항목으로 새 메모와 변경을 반영합니다. Apple 원본은 읽기만 하며, MORI와 원본이 함께 수정된 경우 비교 후 선택합니다. 현재 본문은 일반 텍스트로 가져오고 사진·PDF·표·체크 상태는 보존하지 않습니다.
npm install
npm run dev
확인
npm run test
npm run build
node scripts/smoke.mjs
node scripts/startup-smoke.mjs
node scripts/quick-note-smoke.mjs
node scripts/graph-smoke.mjs
npm run package:mac
release/mac-arm64/MORI.app에 Apple Silicon용 로컬 앱이 생성됩니다. npm run package:dmg는 무료 공개 베타용 Apple Silicon DMG를 만듭니다. 현재 빌드는 Developer ID 서명·공증 전 단계이며 배포 채널과 설치 안내는 배포 계획을 따릅니다. DMG의 MORI.app 안에 연결 스킬을 포함합니다. 앱 설정에서 설치하며, Codex·Claude 실행 프로그램은 별도로 준비해야 합니다.
0.5.0에는 추천 메모 바로 연결, 연결 현황, 사용 가이드가 포함됩니다. 변경 내용과 검증을 참고하세요.
MORI 0.2.0: 기본 ⌘⇧Space로 백그라운드 빠른 메모 창을 열고 ⌘Enter로 미분류에 저장합니다. 앱 창을 닫아도 메뉴 막대 M에서 대기합니다. 완전 종료 시 전역 단축키도 종료되며, 설정의 로그인 시 MORI 자동 실행을 켜면 다음 로그인부터 자동으로 실행됩니다. Escape로 숨긴 빠른 메모 초안은 앱을 완전히 종료하기 전에 저장하세요.
기능
문서 공유: 메모의 공유·내보내기 또는 보고서의 PDF·HTML·웹 공유에서 공개될 내용을 확인하고 PDF·HTML 파일로 내보냅니다. 웹 공유는 계정 서버가 연결된 상용 버전의 Pro·체험 계정에서 제공합니다. 받는 사람은 설치·가입 없이 읽고 작성자는 업데이트·공유 중단을 선택합니다. 공개 범위와 운영 연결을 참고하세요.
주간보고·맞춤 템플릿 무료 체험: 왼쪽 주간보고 만들기에서 기간과 기록을 선택하고 주간보고·스탠드업·회고 또는 저장한 회사 양식으로 초안을 만듭니다. AI 없이 원문을 모으거나 기존 AI 연결로 생성할 수 있습니다. 출처를 확인하고 수정한 뒤 복사·Markdown 내보내기·새 메모 저장을 선택하세요. 원본 메모는 유지합니다. 사용법·제한·검증 범위를 참고하세요.
0.9.0 외부 메모 즉시 반영: 연결 스킬 등 외부 도구가 보관함 Notes 폴더에 저장한 메모를 앱을 다시 열지 않아도 목록에 반영합니다. node scripts/external-note-smoke.mjs로 확인합니다.
데일리 할 일 모음: 왼쪽 오늘 데일리 열기는 같은 날짜의 노트를 재사용합니다. 다른 메모에서 오늘 할 일로 보내기를 눌러 미완료 체크리스트를 선택하거나 할 일을 직접 입력하세요. 원본 링크와 함께 추가되며 중복은 건너뜁니다. 오늘 데일리의 미완료 할 일 가져오기로 지난 데일리 항목을 선택해 이월할 수 있습니다. 원본 메모와 완료 상태는 변경하지 않습니다.
0.7.0 Google Calendar 연동: 설정에서 OAuth 데스크톱 JSON 선택 → Google 로그인 → 캘린더 선택 → 오늘 일정 가져오기를 사용합니다. 데일리를 열 때 자동 갱신할 수도 있습니다. 최초 연결과 동작 안내를 참고하세요. 실제 계정 로그인 검증은 별도로 필요합니다.
0.8.0 담당 업무 연동: 설정의 담당 업무 → 오늘 데일리에서 Jira Cloud·GitHub.com·GitLab.com 계정을 연결합니다. 프로젝트 및 미완료/전체 필터를 선택해 내 담당 이슈를 가져오고, 오늘 데일리를 열 때 갱신할 수 있습니다. MORI에서 체크해도 원본 상태는 바뀌지 않습니다. 토큰 준비·사용법·검증 범위를 참고하세요. 실제 사용자 계정 검증은 별도로 필요합니다.
0.4.2 미리보기 체크리스트: Markdown 미리보기의 체크박스를 클릭하거나 키보드로 초점을 이동한 뒤 Space를 누르면 원문의 - [ ] / - [x]가 바뀌고 자동 저장됩니다. 중첩·번호·인용 목록도 지원하며 코드 블록의 예제는 변경하지 않습니다.
0.3.0 메모 연결 그래프: 기본 화면의 점은 메모, 색 영역은 폴더, 화살표는 실제 문서 참조입니다. 메모를 선택하면 본문 미리보기·수정 날짜·들어오는/나가는 링크가 표시됩니다. 폴더 필터와 연결된 메모만으로 탐색 범위를 좁힐 수 있습니다. 폴더 요약으로 전환하면 기존 집계 화면을 볼 수 있습니다.
폴더 요약: 왼쪽 그래프에서 폴더별 메모 수와 폴더 간 링크 수를 확인합니다. 폴더 → 메모 순서로 선택하면 들어오는 링크·나가는 링크·미해결 링크가 표시됩니다. 확대 버튼으로 넓게 보고, 이 메모 열기로 편집합니다. 같은 폴더에 속한다는 이유로 연결선을 만들지 않습니다.
- Markdown 원문 저장, 자동 저장, 버전 충돌 감지, 휴지통·복구, 내보내기
- 폴더 생성·이름 변경·삭제·이동, 폴더별 필터와 메모 수
[[폴더/문서]] 자동완성, 내부 링크, 백링크, 관련 메모, 문서 그래프- 요청할 때 실행하는 Codex CLI·Claude CLI·OpenAI API 요약/풀어쓰기/회의록/연결 찾기
- 요약 결과 미리보기, 복사, 원문 아래 추가
- 캡처 삽입, 빠른 메모, 사용자 지정 단축키와 AI 명령
설정에서 로컬 기반 Codex/Claude CLI 또는 원격 OpenAI API를 선택합니다. CLI는 로그인된 실행 파일을 사용합니다. OpenAI API 키는 macOS safeStorage로 암호화해 보관함 밖에 저장합니다. API 기본 모델은 gpt-5-nano이며 모델은 선택 목록으로 지정합니다.
Codex의 기본 모델은 요청한 Luna 계열의 gpt-5.6-luna입니다. 맥에 설치된 codex exec를 로컬에서 호출하는 방식입니다. 앱에 별도 API 키나 Ollama를 입력하지 않으며, 모델 추론은 Codex 서비스에서 수행됩니다. 완전 오프라인 Ollama는 별도 확장 후보입니다. 본문 아래에 AI 결과를 추가하면 저장 성공 후 팝업이 닫히고 편집기로 돌아갑니다.
휴지통은 제목과 내용 미리보기를 표시합니다. 각 카드에서 복원하거나 영구 삭제 → 영구 삭제 확인으로 본문·버전 기록·저장된 AI 결과를 삭제할 수 있습니다. 첨부 파일과 이미 내보낸 외부 백업은 유지합니다.
왼쪽 검색창에서 제목·내용을 검색합니다. 기본 ⌘K로 검색창에 이동하며 기존 검색어가 선택됩니다. AI 창에서도 검색으로 이동할 수 있습니다. Enter로 첫 검색 결과를 열고 편집하며, Escape로 검색을 지우고 본문으로 돌아갑니다.
AI로 작성·정리 → AI에게 작성 요청 → 초안 작성으로 본문 없이도 문서를 생성합니다. 빈 메모에는 결과가 자동으로 입력됩니다. 기존 본문이 있거나 생성 중 내용을 수정했다면 결과 미리보기만 제공하며 원문을 유지합니다. AI 창을 검색 단축키로 닫아도 진행 중인 생성은 계속됩니다. 창의 닫기 버튼은 작업을 취소합니다.
메모 위의 요약하기는 버튼을 누를 때만 실행하고, AI로 작성·정리의 풀어 쓰기·회의록 정리는 기존 본문을 사용합니다.
설정의 단축키 입력칸에서 원하는 조합을 누르고 설정 저장을 누릅니다. Delete로 전역 단축키를 해제합니다. 다른 앱과 충돌하면 오류를 표시하며 기존 설정을 유지합니다. 캡처·빠른 메모 전역 단축키는 앱이 실행 중일 때 동작합니다.
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
