페어리 (fairy)
화면 위를 돌아다니는 페어리가 할 일, 일정, 메모를 같이 챙겨 주는 데스크톱 비서예요.
맥과 윈도우용이에요(리눅스는 시험판). 홈페이지는 fairy.moilga.com
받기 | 설치 안내 | 사용 가이드 | 변경 이력
예전 이름은 짝꿍(Jjakkung)이었어요. 짝꿍을 쓰던 컴퓨터에서 페어리를 처음 켜면 할 일, 메모, 설정 같은 데이터를 저절로 옮겨 와요(설치 안내).
페어리는 이런 앱이에요
화면 한쪽에 강아지, 고양이 같은 작은 페어리가 살아요. 가만히 있다가 가끔 걸어 다니고, 창 위에 올라앉고, 마우스를 쳐다보고, 쓰다듬으면 하트를 띄워요. 페어리를 누르면 오늘 할 일과 일정이 담긴 패널이 열리고, 우클릭하면 AI와 대화하거나 화면을 같이 보며 물어볼 수 있어요.
- 페어리: 기본 페어리 다섯(콩이, 냥이, 삐약이, 멍멍이, 토순이)과 그림 친구 둘(밀크, 초코). 반려동물이나 인형 사진 한 장으로 나만의 페어리도 만들 수 있어요.
- 비서: 할 일, 메모, 일정, 집중 타이머, 하루 회고. "내일 3시 회의"처럼 한 줄로 넣으면 날짜와 시각을 알아들어요.
- AI: 이 컴퓨터에 설치해 둔 Claude Code, Codex, Cursor, Gemini CLI를 불러 대화해요. 하나도 없으면 컴퓨터 안에서만 도는 무료 AI를 받아 쓸 수 있어요.
이 문서의 화면은 모두 실제 앱을 띄워 찍었어요. 할 일, 일정, 메모는 지어낸 예시예요.
한눈에 보기
페어리
- 드래그로 옮기고, 잡아서 휙 놓으면 던져져서 통통 튀어요. 좌우로 문지르면 쓰다듬기예요.
- 기본 페어리는 입체(three.js)로 그려요. 모습을 피규어, 게임 캐릭터, 실사, 복슬복슬(시험) 중에 고르거나, 예전처럼 납작한 2D로 둘 수 있어요.
- 기분, 배부름, 친밀도가 있어요. 할 일을 끝내면 코인이 쌓이고, 코인으로 밥과 장난감, 집을 사 줄 수 있어요. 오래 안 놀아 주면 삐지기도 해요.
- 산 집은 페어리 우클릭 메뉴나 집 우클릭 메뉴의 집 숨기기로 잠깐 치워 둘 수 있어요. 단계, 모양, 자리는 그대로 남고, 페어리 우클릭 메뉴의 "집 다시 보이기"나 상점의 "집 보이기"로 다시 꺼내요.
- 페어리 공유로 친구 페어리를 세 마리까지 초대해 같이 돌아다니게 할 수 있어요. 페어리는
.fairy 파일로 내보내 친구에게 줄 수 있어요 (예전 .jjpet 파일도 그대로 열려요).
- 다른 앱을 전체 화면으로 쓰거나 발표할 때는 가려지고, 단축키로 잠깐 숨길 수도 있어요.
할 일, 메모, 일정
페어리를 누르면 패널이 열려요. 탭은 오늘, 할 일, 메모, 일정, 상점이에요.
- 오늘: 다음 할 일과 그 단계, 바로 시작하는 집중 타이머(15, 25, 50분. 끝내면 코인 5, 10, 25개), 오늘 일정, 마감, 이번 주 기록, 업적, 페어리의 일기.
- 할 일: 마감일과 시각, 중요 표시, 반복(매일, 평일, 매주, 매달), 단계 체크리스트, 미리 알림(시각이 있으면 기본 하루 전과 1시간 전, 날짜만 있으면 전날 저녁). 끝내면 코인을 받아요.
- 메모: 찾기, AI가 대화 중에 남긴 메모는
AI 표시가 붙어요.
- 일정: 알림(기본 10분 전), 종일 일정, 알림에서 화상 회의 주소 바로 열기. 구글 캘린더 같은 캘린더의
.ics 비공개 주소를 넣으면 30분마다 앞으로 60일 일정을 가져와요.
- 달력: 일정 탭에서 목록과 달력을 골라요. 월 보기와 주 보기에 일정, 가져온 일정, 마감 있는 할 일, 반복 할 일의 다음 회차가 같이 보이고, 날짜를 누르면 그날 목록이 나오고 바로 그날에 넣을 수 있어요. 한국어에서는 공휴일이 빨간 날로 보여요.
- 고정: 메모, 할 일, 일정은 핀 단추(줄에 마우스를 올리면 보여요)나 우클릭으로 목록 맨 위에 고정해요. 일정은 목록 맨 위 "고정" 칸에 모이고, 달력과 오늘 탭은 날짜 순서 그대로 핀만 보여요.
- 빠른 입력: 어디서든 단축키 한 번으로 한 줄 입력 창이 떠요. "내일 3시 회의", "매일 운동", "금요일 휴가"처럼 써요(한국어와 영어).
어두운 모드도 운영체제 설정을 따라가요.
비서와 대화
- 고를 수 있는 AI: Claude Code(
claude), Codex(codex), Cursor(cursor-agent, 실험적), Gemini(gemini, 실험적), 직접 추가한 CLI, 무료 AI(Qwen3 1.7B 또는 0.6B, 이 컴퓨터 안에서만 돌아요).
- 내 할 일 같이 보내기를 켜면 "오늘 뭐부터 할까?"에 내 할 일과 일정을 보고 답해요.
- 페어리 도구 쓰기를 켜면 대화 중에 "내일 장보기 할 일로 넣어 줘"라고 하면 AI가 페어리에 직접 넣어요(Claude, Codex). 지우기, 고치기, 메모 덧붙이기는 페어리가 말풍선으로 먼저 물어보고 "해 줘"를 눌러야 해요.
- 같이 보기: 페어리를 우클릭해 "같이 보기"를 고르고 화면 일부를 고르면, 그 그림을 AI에게 보여 주며 물어볼 수 있어요.
- 성격과 말투(다정한 친구, 존댓말 비서, 츤데레, 차분한 선생님, 활발한 응원단, 느긋한 고양이, 신난 강아지, 사극 선비, 아나운서). 설정 → AI → 말투에서 말 높이, 말끝, 나를 부르는 말, 자주 하는 말까지 정해 내 말투를 만들 수도 있어요. 페어리 규칙, AI 사용량 보기, 내 MCP 도구.
- 반대로 Claude Code나 Codex 안에서 페어리를 MCP 서버로 연결해 "이거 페어리 할 일에 넣어 줘"라고 할 수도 있어요.
AI별로 되는 일
설정 → AI → 이 컴퓨터에서 찾은 AI와 첫 안내가 설치와 로그인 여부만 가볍게 확인해 "찾았어 ✓", "로그인이 필요해", "없어"로 보여 줘요(질문은 보내지 않아요). AI마다 페어리에서 되는 일은 아래와 같아요.
| AI | 대화 | 할 일 정리 | 화면 보기 | 페어리 도구(MCP) | 비용 | 읽기 전용 |
|---|
| Claude Code | O | O | O | O | 내 구독 | 막아 둠 |
| Codex | O | O | O | O | 내 구독 | 막아 둠 |
| Cursor (확인 전) | O | O | - | - | 내 구독 | 막아 둠 |
| Gemini CLI (확인 전) | O | O | - | - | 내 구독 | 막아 둠 |
| 내 컴퓨터 AI (무료) | O | O | - | - | 무료 | 도구 없음 |
| 직접 추가한 AI | O | O | - | - | 그 AI 마다 | 막을 수 없음 |
- 할 일 정리는 내 할 일과 일정을 알고 답하기, 메모 다듬기, 답을 할 일로 만들기예요. 확인 전은 아직 실제 출력으로 시험하지 못했다는 뜻이에요.
- 읽기 전용: 페어리가 부르는 AI는 읽기만 해요. 파일을 고치거나 명령을 실행하거나 메일, 메시지를 보내는 도구는 내 AI 설정(
~/.claude, ~/.codex)이 어떻든 막아요. 대화, 일기 다듬기, 말로 만들기, 그림 설계도 모두 같아요. 열려 있는 건 페어리 도구(할 일, 메모, 일정)뿐이고, 지우기와 고치기는 페어리가 먼저 물어봐요.
- Claude Code: 내장 도구를 끄고 쓰기 도구를 명시 거부하며(
--tools, --disallowedTools), 허락하지 않은 것은 묻지 않고 거절해요(--permission-mode dontAsk). "내 AI 설정 없이 부르기"를 끄고 내 MCP 도구를 쓰면 이름이 읽기(가져오기, 찾기)로 보이는 도구만 통과시키는 훅이 붙어요.
- Codex: 읽기 전용 샌드박스와 승인 거절(
sandbox_mode, approval_policy)을 박고, 앱 연결, 브라우저와 컴퓨터 조작, 플러그인을 끄고, 내 설정의 MCP 서버를 이번 실행에서 꺼요.
- Cursor는 읽기 전용
--mode ask, Gemini CLI는 승인 방식 --approval-mode default(확인이 필요한 도구는 거절)로 불러요.
- 직접 추가한 AI는 막을 방법이 없어서 그 명령이 하는 일은 내가 책임져요.
내 페어리 만들기
사진 한 장으로 페어리를 만들어요. 배경 지우기는 이 컴퓨터 안에서 해요.
마지막 단계에서 모습을 골라요.
- 사진 그대로: 오린 사진을 그대로 써요.
- 입체 피규어: Claude나 Codex가 사진을 보고 입체 설계도를 그려 360도로 돌려 볼 수 있는 피규어를 만들어요. 다듬은 사진 한 장만 보내고 AI 사용량을 조금 써요.
- 2.5D 입체: 사진의 깊이를 재서 살짝 입체감 있게 움직여요(깊이 모델은 이 컴퓨터에서 돌아요).
AI가 연결돼 있으면 사진 없이 말로 만들기도 돼요. 만들고 싶은 모습을 적으면 AI가 입체 피규어로 만들고, "눈 더 크게"처럼 말로 고칠 수 있어요. 다른 사람의 캐릭터를 닮게 만든 페어리는 개인적으로 즐겨 주세요.
사진을 귀여운 그림으로 다시 그리고 싶다면 AI 일러스트로 다시 그리기를 골라요. 그리는 곳은 셋이에요.
| 그리는 곳 | 횟수 | 사진이 나가는 곳 |
|---|
| 무료 서버 (기본) | 하루 몇 번. 횟수는 인터넷 연결마다 따로 세고 하루가 지나면 다시 채워져요. 무료 Hugging Face 토큰을 넣으면 더 그릴 수 있어요 | Hugging Face의 무료 그림 서버(다른 사람이 운영) |
| Gemini 앱에서 만들기 | Gemini 앱의 무료 사용량만큼 | 내가 직접 Gemini(구글)에 올려요. 페어리 앱은 보내지 않아요 |
| 내 컴퓨터에서 | 제한 없음. 처음 한 번 준비가 필요해요 | 나가지 않아요 |
- Gemini 앱(무료)에서 만들기: 단추를 누르면 요청문이 복사되고 Gemini가 열려요. 고른 사진과 요청문을 보내고, 나온 그림을 페어리 만들기 창에 끌어다 놓으면 이어서 만들어요. 구글 계정만 있으면 돼요.
- 내 컴퓨터에서 그리기: Apple 칩 Mac(macOS 14 이상)은 mflux로, 윈도우 x64와 인텔 Mac, macOS 13 Apple 칩 Mac은 sd.cpp로 그려요. 메모리 8GB 이상이 필요하고, 처음 한 번 mflux는 약 16GB를 받아 약 5GB를 남기고, sd.cpp는 약 5.2GB를 받아요. 그래픽 칩 없이 CPU로 그리면 한 장에 꽤 오래 걸려요.
- Hugging Face 토큰: huggingface.co/settings/tokens에서 무료로 만들 수 있어요. 토큰은 그림 서버에도 같이 가니 권한을 가장 적게 준 Fine-grained 토큰을 추천해요. 이 컴퓨터에만 저장하고(운영체제 열쇠로 암호화할 수 있으면 암호화) 백업에도 넣지 않아요.
더 챙겨 주는 것
- 오늘 뭐부터?: 채팅에 "오늘 뭐부터 할까?" 라고 물으면 AI 없이도 할 일 순서와 집중할 빈 시간을 알려 줘요. 페어리 우클릭 메뉴 "오늘 뭐부터?" 도 같아요.
- 습관: 반복 할 일을 날마다 체크하고 최근 12주를 잔디로 봐요. 끊겨도 벌은 없어요.
- 아침 계획: AI 없이도 꼭 할 일 셋과 일정 사이 집중 시간을 같이 정해요.
- 알림 미루기: 알림에서 10분, 1시간, 내일 아침으로 미루고, 빠른 입력에 "30분 뒤 알려 줘"라고 써도 돼요.
- 페어리가 아는 것: 페어리가 기억하는 것을 보고 고치고 잊게 할 수 있어요. 생일과 좋아하는 것을 알려 주면 AI 없이도 챙겨 줘요.
- 자라는 페어리와 철마다 옷: 기본 페어리가 함께한 날만큼 자라고, 계절과 명절마다 옷을 입어요 (설정 → 페어리에서 끄기).
- 주간 카드: 이번 주 기록을 귀여운 카드 그림으로 저장해요.
- 내보내기: 메모는 .md, 할 일은 .csv, 일정은 .ics 로 (설정 → 데이터와 계정).
- 페어리 갤러리와 페어리 파일: 설정 → 페어리 → 페어리 갤러리에서 공식 페어리를 데려오고, 페어리는 .fairy 파일로 친구와 주고받아요 (형식).
- 다른 앱에서 부르기:
fairy://add?text=내일 3시 회의 같은 주소로 단축어, Raycast, Alfred 에서 할 일을 넣어요 (연결 안내).
- 배터리일 때 움직임 줄이기: 켜기(기본) / 끄기 / 항상 줄이기를 설정 → 편의나 페어리 우클릭 메뉴에서 골라요.
- 접근성: 말풍선 읽어 주기, 키보드로 페어리 다루기, 운영체제의 움직임 줄이기 설정 따르기.
설정
설정은 페어리, 비서, AI, 편의, 데이터, 정보 여섯 탭이고, 맨 위 찾기 칸으로 바로 찾을 수 있어요.
설치
설치 파일은 공개 레포 fairy-releases 의 Releases 에 있어요. 받을 파일과 처음 열 때 경고 넘기는 법은 설치 안내 에 있어요. 짧게 정리하면 이래요.
- 맥: 애플 실리콘은
fairy-<버전>-mac-arm64.dmg, 인텔은 fairy-<버전>-mac-x64.dmg. 아직 애플 개발자 서명 전이라 처음 한 번 시스템 설정 → 개인정보 보호 및 보안에서 "그래도 열기"를 눌러야 해요. 막히면 홈페이지 맥에 설치하기를 보세요(dmg 창 아래 "열리지 않으면 여기" 링크도 같은 곳으로 가요).
- 윈도우:
fairy-<버전>-win-x64.exe. "Windows의 PC 보호" 창이 뜨면 추가 정보 → 실행. 관리자 권한 없이 설치돼요. 윈도우는 아직 확인 중이에요(체크리스트).
- 리눅스(시험판):
fairy-<버전>-linux-x64.tar.xz(풀어서 fairy 실행) 또는 fairy-<버전>-linux-x86_64.AppImage(실행 권한을 주고 실행).
- 새 버전 확인, AI 모델 목록, 페어리 갤러리는 공개 레포
milcho0604/fairy-releases 의 릴리스와 catalog/models.json, gallery/ 를 읽어요(이 소스 레포는 읽지 않아요). 레포가 공개되어 있지 않거나 연결이 안 되면 확인만 조용히 건너뛰고, 모델 목록은 앱에 들어 있는 것을 써요.
- 맥과 윈도우 설치판은 새 버전을 미리 받아 두고 페어리가 "다시 켜서 업데이트"를 띄워요. 누를 때만 설치해요. 자동 설치가 안 되거나 "받으러 가기"를 누르면 홈페이지 설치 안내를 열어요. 리눅스는 페어리가 릴리스 페이지를 열어 줘요.
- 꼭 필요한 업데이트가 나오면 업데이트하기 전까지 AI 대화가 잠겨요(확인을 못 하면 잠그지 않아요). 설정 → 정보 → "새 버전 알림"을 끄면 새 버전 말풍선만 쉬고, 꼭 필요한 업데이트 확인은 계속해요.
시스템 요구 사항과 크기
| 내용 |
|---|
| 운영체제 | macOS 13 이상(애플 실리콘, 인텔), Windows 10 이상 x64, 리눅스 x64(시험판) |
| AI 대화 | Claude Code, Codex, Cursor, Gemini CLI 중 하나를 설치하고 로그인해 두거나, 무료 AI 모델(Qwen3 1.7B 약 940MB, 0.6B 약 400MB)을 받아요 |
| 설치 파일 크기 | 리눅스 0.1.0 실측(2026-10-11): tar.xz 약 86MB, AppImage 약 100MB, 풀면 약 294MB. 맥과 윈도우 설치 파일은 릴리스 페이지에 크기가 보여요. 무료 AI 를 처음 쓸 때 엔진(5~11MB)을 모델과 함께 한 번 받아요 |
| 처음 쓸 때 받는 것 | 사진 페어리 배경 지우기 모델 약 84MB와 사진 AI 엔진 약 17MB, 2.5D 깊이 모델 약 50MB(쓸 때만), 그림용 배경 지우기 모델 약 176MB(만화나 그림에 필요할 때만) |
| 내 컴퓨터에서 그리기 | 메모리 8GB 이상, 빈 공간 7~20GB (엔진에 따라. sd.cpp 는 약 5.2GB, mflux 는 약 16GB를 받아요) |
받은 모델은 설정 → 데이터와 계정 → 저장 공간에서 크기를 보고 지울 수 있어요.
처음 켜기
처음 켜면 네 쪽짜리 안내가 떠요. 페어리 이름과 모습을 고르고, 만나는 시간을 정하고, 같이 보기 권한과 AI 연결을 확인하고, 알아 두면 좋은 조작을 봐요. 언제든 건너뛸 수 있고 나중에 설정에서 다 바꿀 수 있어요.
자세한 사용법은 사용 가이드 에 단계별로 정리해 뒀어요.
단축키
맥은 Cmd, Option, 윈도우는 Ctrl, Alt 예요. 어디서나 쓰는 여섯 개는 설정 → 편의에서 바꾸거나 끌 수 있어요.
| 어디서 | 키 | 하는 일 |
|---|
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + N | 빠른 입력 (할 일이나 일정 한 줄) |
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + J | 대화 창 열기 |
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + L | 같이 보기 |
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + T | 패널 열고 닫기 |
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + H | 페어리 숨기기, 다시 보이기 |
| 어디서나 | Cmd/Ctrl + Option/Alt + Shift + P | 페어리 고르기 (키보드로 다루기: Enter 패널, 메뉴 키 우클릭 메뉴, 화살표 걷기, Esc 그만) |
| 마우스가 페어리 위에 있을 때 | Cmd/Ctrl + Option/Alt + = / - / 0 | 페어리 크게, 작게, 원래대로 |
| 마우스가 페어리 위에 있을 때 | Cmd/Ctrl + 휠, 트랙패드 핀치 | 페어리 크기 |
| 패널 | Cmd/Ctrl + 1 ~ 5 | 오늘, 할 일, 메모, 일정, 상점 |
| 패널 | Cmd/Ctrl + Z | 방금 지운 것, 끝낸 것 되돌리기 |
| 패널, 빠른 입력 | Esc | 입력칸 비우기, 창 닫기 |
| 채팅 | Enter / Shift + Enter | 보내기 / 줄 바꾸기 |
| 채팅 | Esc | 답 멈추기 |
| 채팅 | Cmd/Ctrl + N | 새 대화 |
| 채팅 | ↑ | 마지막 질문 다시 불러오기 |
| 설정 | Cmd/Ctrl + F | 설정 찾기 |
| 설정 | Cmd/Ctrl + [ / ], Cmd/Ctrl + 1 ~ 6 | 탭 옮기기 |
| 시작 안내 | ← / → | 이전, 다음 쪽 |
개인정보: 무엇이 나가고 무엇이 남나요
페어리 앱 자체는 서버가 없어요. 할 일, 메모, 일정, 코인, 페어리, 설정은 모두 이 컴퓨터의 사용자 데이터 폴더에 있어요.
이 컴퓨터에만 남는 것
- 할 일, 메모, 일정, 일기, 코인과 페어리 상태, 페어리가 기억하는 것과 페어리 규칙 (
jjakkung.db, settings.json 등)
- 채팅 창의 최근 대화 40개 (
chat-history.json, 붙인 그림은 빼고)
- 사진 페어리 만들기의 배경 지우기와 2.5D 깊이 재기, 무료 AI 대화, 내 컴퓨터에서 그리기
- 구글 캘린더 연결 토큰과 Hugging Face 토큰 (운영체제 열쇠로 암호화할 수 있으면 암호화해요)
- 내 기록(쓴 날, 끝낸 할 일 수 같은 숫자)과 진단 기록(
logs/main.log). 질문, 답, 할 일과 일정 제목은 진단 기록에 남기지 않아요. 도움 보내기(아래)에 붙일 때는 경로, 주소, 토큰, 전화번호 같은 것을 한 번 더 가리고, 내가 복사해서 직접 보내요
같이 보기 화면과 AI 프로그램의 기록
- 같이 보기로 찍은 화면은 페어리가 디스크에 저장하지 않아요(Codex에 넘길 때만 잠깐 임시 파일로 두고 바로 지워요).
- 화면이나 그림을 실은 질문은 Claude Code와 Codex가 자기 대화 기록에도 남기지 않게 불러요. 보낸 그림은 그 AI 회사의 보관 정책을 따라요.
- 그 밖의 대화는 Claude Code가
~/.claude/projects/ 안의 페어리 전용 폴더에, Codex는 페어리 데이터 폴더의 codex-home/에 이어가기용 기록을 남겨요. 채팅 창의 기록 안 남김을 켜면 남기지 않고, 설정 → 데이터와 계정 → AI 기록 지우기로 페어리 것만 지울 수 있어요(내 다른 Claude, Codex 기록과 로그인은 그대로).
같이 타자 치기와 매일 쪽지
같이 타자 치기는 어떤 키를 눌렀는지 읽지 않아요. 운영체제가 알려 주는 '마지막 입력 뒤 지난 시간'과 커서 위치만 1초에 두 번까지 보고, 아무것도 저장하거나 보내지 않아요. 매일 쪽지는 이 컴퓨터의 기록으로만 쓰고 AI를 부르지 않아요. AI가 페어리 도구(MCP)를 부르면 데이터 폴더의 빈 파일 mcp-beat 의 시각만 바뀌어요(페어리가 같이 일하는 표정을 짓는 데 써요).
밖으로 나가는 것 (내가 그 기능을 쓸 때만)
| 기능 | 어디로 | 무엇이 |
|---|
| AI 대화, 같이 보기 | 내가 고른 AI CLI가 연결된 곳 (Anthropic, OpenAI, Cursor, Google) | 질문, 고른 화면 그림. 질문마다 페어리 이름과 성격, 페어리 규칙, 내가 허락한 "페어리가 기억하는 것"이 같이 가요. "내 할 일 같이 보내기"를 켜면 안 끝낸 할 일 제목과 마감, 오늘 남은 일정 제목 |
| 메모 요약, 다듬기, 할 일로 쪼개기 | 내가 고른 AI | 그 메모 글(고른 부분만 고르면 그 부분) |
| 일기를 AI로 다듬기 (설정 → AI) | 내가 고른 AI | 그날 숫자(끝낸 할 일 수 등)와 페어리가 쓴 일기 문장. 할 일 제목은 보내지 않아요 |
| 입체 피규어 만들기 | Claude 또는 Codex | 다듬은 사진 한 장 |
| 말로 만들기 | 내가 연결한 AI (Claude, Codex, Cursor, Gemini CLI) | 적은 글과 고칠 점. Claude는 캐릭터 모습을 찾으려고 웹 검색을 쓸 수 있어요 |
| AI 일러스트 (무료 서버) | Hugging Face의 무료 그림 서버 | 고른 사진, 바라는 점, 넣었다면 HF 토큰 |
| 캘린더 가져오기 | 내가 넣은 .ics 주소 | 요청만 (받아 오기) |
| 구글 캘린더 연결 | 구글 캘린더 API (내가 연결했을 때만) | 페어리에서 넣은 일정의 제목, 시각, 알림을 보내고, 고른 캘린더 일정의 제목과 시각을 읽어 와요 (읽은 것은 이 컴퓨터에만, AI 로 보내지 않아요) |
| 모델과 도구 받기 | GitHub, Hugging Face, jsDelivr/unpkg, PyPI 등 | 요청만 (받아 오기) |
| 업데이트 확인, 모델 목록, 갤러리 | GitHub (milcho0604/fairy-releases 릴리스와 catalog/models.json, gallery/) | 요청만 (앱 이름과 버전) |
Claude Code와 Codex는 기본으로 내 훅, MCP, 스킬을 싣지 않고 불러요(설정 → AI → "내 AI 설정 없이 부르기"). 그 설정을 켜도 페어리가 부르는 AI는 읽기 전용이에요(위 "AI별로 되는 일").
도움 보내기: 문제가 생기면 설정 → 정보 → 도움 보내기(설정 창에서 Cmd/Ctrl+Shift+H)가 앱 판, 운영체제, 켜진 기능, AI 감지 결과, 서버 연결 상태(주소와 토큰은 빼고), 최근 진단 기록을 한 글로 묶어 미리 보여 줘요. 토큰과 키, 이메일, 폴더 경로 속 이름, 할 일, 메모, 일정 제목, 대화 내용은 가려요. 어디로도 자동으로 보내지 않고, 내가 읽어 보고 복사하거나 파일로 저장해 직접 보내요.
백업과 옮기기
설정 → 데이터와 계정 → 백업과 옮기기에서 할 일, 메모, 일정, 코인, 페어리, 설정을 백업 파일 하나(.fairybackup)로 만들고, 다른 컴퓨터에서 그 파일을 두 번 누르거나 가져오기로 복원할 수 있어요. 바꾸기 전 지금 데이터는 보관해 두고 되돌릴 수 있어요. 받은 모델과 내 컴퓨터에서 그리기 도구는 크기가 커서 넣지 않아요(다른 컴퓨터에서 다시 받으면 돼요). 페어리 하나만 친구에게 줄 때는 페어리 내보내기로 .fairy 파일을 만들어요.
앱을 지워도 데이터는 남아요. 완전히 지우는 법(데이터 폴더와 AI 프로그램 기록 위치)은 설치 안내의 지우기에 있어요.
자주 묻는 질문
AI 프로그램이 하나도 없어도 쓸 수 있나요?
네. 페어리, 할 일, 메모, 일정은 AI 없이 다 돼요. 대화는 채팅 창의 AI 고르기에서 "무료 AI"를 고르면 처음 한 번 모델을 받고 이 컴퓨터 안에서만 돌아요.
채팅 창에 "설치 안 됨"이라고 나와요.
페어리 앱은 AI를 직접 갖고 있지 않고, 터미널에서 쓰는 AI 프로그램(CLI)을 불러요. 그 프로그램을 설치하고 로그인한 뒤 페어리를 다시 켜 보세요. 목록에 없는 CLI는 "AI 추가, 관리"에서 직접 넣을 수 있어요.
맥에서 같이 보기가 안 돼요.
시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음에서 fairy를 켜고 페어리를 다시 켜야 해요. 자세한 건 설치 안내에 있어요.
페어리가 작업을 가려요.
페어리 위에서 휠을 그냥 굴리면 아래 창으로 넘어가요. 단축키로 잠깐 숨기거나, 설정 → 페어리에서 "가끔 돌아다니기"를 끄고 크기를 줄여 보세요. 발표나 화면 공유 중에는 저절로 숨어요.
무료 그림 횟수가 끝났대요.
다음 날 다시 채워져요. 지금 바로 만들려면 "Gemini 앱(무료)에서 만들기"를 쓰거나, 무료 Hugging Face 토큰을 넣거나, 되는 컴퓨터라면 "내 컴퓨터에서 그리기"를 골라요.
리눅스에서도 되나요?
시험판이에요. 릴리스에 tar.xz 와 AppImage 를 올리고, 켜지는지는 CI 에서 매번 확인해요. 자동 업데이트는 없고 새 버전이 나오면 페어리가 릴리스 페이지를 열어 줘요. 같이 보기와 창 위에 올라앉기는 데스크톱 환경(X11, Wayland)에 따라 다를 수 있어요.
문제를 알리고 싶어요.
메뉴 막대(윈도우는 작업 표시줄 오른쪽 아래)의 페어리 아이콘 → 의견 보내기. 설정 → 정보의 "기록 복사"로 숫자만 담긴 기록을 같이 붙일 수 있어요.
개발
Node 24를 권해요(.nvmrc, 최소 22.18. 시험이 TypeScript 파일을 그대로 돌려요). 기여 방법은 CONTRIBUTING.md, 보안 문제 알리기는 SECURITY.md를 봐 주세요. 앱 버그는 fairy-releases 의 이슈로 받아요.
npm install
npm run dev # 앱을 띄우고 화면 코드를 고치면 바로 반영
npm run check # 타입 검사 + 린트 + 시험
npm test # 시험만 (node --test "src/**/*.test.ts")
npm run typecheck # 타입 검사만
npm run lint # biome 검사 (고치려면 npm run format)
npm run build # out/ 에 빌드
npm run dist # 지금 컴퓨터용 설치 파일 (dist/)
npm run dist:mac # 맥 dmg (애플 실리콘과 인텔)
npm run dist:win # 윈도우 설치 파일. 릴리스는 GitHub Actions 의 release.yml
npm run dist:linux # 리눅스 tar.xz, AppImage
| 폴더 | 내용 |
|---|
src/main/ | Electron 메인 프로세스 (창, 트레이, DB, AI 실행, MCP 서버) |
src/preload/ | 화면에 열어 줄 기능만 모아 둔 다리 |
src/renderer/ | 화면. 페어리 창은 가볍게 React 없이, 패널과 채팅, 설정, 페어리 만들기는 React |
src/shared/ | 화면과 메인이 같이 쓰는 순수 로직, 번역(i18n/), 시험 |
scripts/ | 빌드 보조, 개발 점검 도구(scripts/dev/) |
catalog/ | 앱이 하루 한 번 받아 보는 AI 모델 목록 |
spike/ | 0단계 실험 앱 |
실제 앱을 띄워 상태를 넣고 화면을 찍어 보는 도구는 scripts/dev/README.md에 있어요. 테스트용으로 띄울 때는 늘 JJ_NO_FOCUS=1과 빈 JJ_USER_DATA 폴더를 써요.
라이선스
MIT © 2026 milcho0604
배경 지우기 모델(IS-Net), 무료 AI 모델(Qwen3, Apache-2.0), 그림 모델 같은 받아 쓰는 모델은 각자의 라이선스를 따라요.
English summary
fairy (페어리, formerly Jjakkung) is a desktop app for macOS 13+ and Windows 10+ (Linux x64 builds are experimental) where a little fairy, a small creature like a puppy or a kitten, lives on your screen and doubles as a personal assistant. Site: fairy.moilga.com.
- Fairy: five built-in 3D fairies (Bean, Kitty, Chick, Puppy, Bunny) plus two illustrated ones (Milk, Choco). Drag, throw, pet it, feed it with coins earned from finished to-dos, or make your own fairy from a photo (background removal runs locally; optional 3D figure, 2.5D depth, or AI illustration via a free Hugging Face Space, the Gemini app, or on-device drawing).
- Assistant: click the fairy for a panel with Today, To-dos, Notes, Events and Shop. Natural-language quick add ("meeting tomorrow 3pm", Korean and English), repeating to-dos, reminders, a focus timer, daily review,
.ics calendar import.
- AI: chat through the AI CLIs you already have (Claude Code, Codex, Cursor, Gemini) or a free local model (Qwen3). "Look together" sends a selected screen area to your AI. Fairy also runs as an MCP server so Claude Code or Codex can add to-dos, notes and events.
- Privacy: no fairy server. Your data stays on your computer; things leave only when you use a feature that needs it (your chosen AI, the free illustration server, calendar URLs, downloads, update checks). Questions that carry a screenshot are never saved in the AI CLI's own history, and Settings → Data → Clear AI history removes what Claude Code and Codex kept for fairy. Deletes and edits the chat AI asks for need your OK in the fairy's bubble.
- Updates: update checks, the model catalog and the fairy gallery read the public repository milcho0604/fairy-releases (its releases,
catalog/models.json and gallery/), never this source repository; when offline, the check is skipped and the built-in catalog is used. Turning off new version notices only silences the bubble; required updates are still checked, and AI chat stays locked until you install one.
- Install: download from fairy-releases Releases; details in docs/install.md (Korean). Bugs go to fairy-releases issues. Builds are not yet signed by Apple or Microsoft, so allow the app once on first launch.
- Develop: Node 24 (
.nvmrc, 22.18+ works), npm install, npm run dev, npm run check. See CONTRIBUTING.md and .
