Floe 앱 알파 — app-v11.3.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (11.3.0) — 처음 쓰는 사람도 막히지 않게, 알약은 내가 둔 자리에

• 플로로가 첫 사용을 안내해요. 처음 설정과 작업실에서 눌러야 할 곳만 밝게 두고, 옆에서 플로로가 말풍선으로 첫 칸까지 알려 줘요. 처음 적은 말은 진짜 프로젝트가 돼요. '건너뛰기'나 Esc로 언제든 끝낼 수 있어요.
• 앱에서 터미널 없이 로그인해요. 처음 설정의 로그인 칸에 정해 둔 명령이 들어 있어서 [실행]만 누르면 돼요.
• 알약을 끌어 원하는 자리로 옮겨요. 놓은 자리는 다음에 켜도 그대로고, 대기 중인 플로로도 같은 자리에 나와요.
• 처음 설정이 작업실과 같은 모습이에요. 카드 색과 제목 굵기를 맞췄고, 카드 위로 삐져나오던 알약을 감췄어요. 왼쪽 플로로의 눈도 커서를 따라와요.
• 처음 설정이 떠 있어도 다른 앱을 누를 수 있어요.
• 관문의 성공 기준이 다음 단계 초안에 반영돼요. 7단계에서 지난 칸을 고칠 수 있고, 코드나 푸시 없이는 5 · 8단계를 넘지 않아요. Windows 허락 카드에 명령이 보이고, 기록 한 장에 바뀐 파일이 남아요.

그 전에 바뀐 것 (11.2.0) — Claude Code와 더 매끄럽게, 플로로는 더 생생하게

• Claude Code가 일하는 동안 플로로가 노트북으로 코드를 쳐요. 일을 시작하면 노트북이 물에서 떠올라 열리고, 끝나면 닫혀 내려가요. 섬을 접어 둬도 알약의 얼굴이 바뀌어요.
• 표정이 자연스럽게 바뀌어요. 눈과 입은 스르르 뜨듯이, 머리 위 표시는 작게 솟아 나와요.
• Claude Code의 허락을 플로로가 자동으로 허용해요(새 기본값). 파일을 고치거나 명령을 쓸 때마다 묻지 않아요. 패키지 설치 · 외부 스크립트 실행도 묻지 않으니 알아 두세요. 지우기 · 강제 푸시 · 비밀값처럼 되돌리기 어려운 일은 계속 물어요. 설정 → 연결에서 끌 수 있어요.
• 장식이 머리에 붙어 같이 움직여요. 플로로 그림체로 다시 그렸고, 뽑는 순간 위에서 떨어져 머리가 살짝 눌려요.
• 옆 칸 섬의 입력 칸이 늘 보여요. 대화가 길어도 입력 칸은 그대로 있고 기록만 스크롤해요.
• 초안을 보는 중에 보낸 말이 칸에 바로 적히지 않아요. 물어보면 플로로가 답하고, 칸에는 내가 누른 것만 적혀요.
• '생각' 표정의 짝짝이 눈을 고쳤어요. 두 눈 다 평소 눈으로 위를 봐요.
• 작은 고침. 지도에서 번호 상자를 눌러도 퀘스트 카드가 올라오지 않아요. 8단계를 다 마친 뒤 Claude Code 알림이 끝난 상태를 풀지 않아요.

그 전에 바뀐 것 (11.1.0) — 11.0.0을 쓰며 걸린 것들을 고친 판

• 처음 설정을 마치면 바로 작업실의 플로로 홈이에요. 옛 섬 화면에서 '퀘스트' 단추를 찾지 않아도 돼요.
• 작업실은 늘 화면 가득 열려요. 저장된 작은 크기로 찌그러져 열리지 않아요. 열어 둔 동안 줄이거나 옮길 수 있고, 다음에 열면 다시 꽉 차요.
• 캔버스 탭을 뺐어요. 작업실의 첫 탭은 퀘스트예요.
• 스크롤바가 눈에 덜 띄어요. 섬과 작업실의 스크롤바를 숨기고, 작업 칸과 가운데 플로로 화면에만 얇고 옅은 막대가 있어요.
• 상자 보기(문서 지도)를 열면 지금 장으로 부드럽게 옮겨 가운데에 둬요. 작업실이 다시 그려져도 지도를 다시 불러오지 않고, 작은 칸을 가리던 띠와 단추는 숨겼어요.
• 책 탭의 README가 읽기 좋아졌어요. 마크다운 기호 대신 굵게 · 인용 · 표로 보여요.
• 작은 화면 고침. 플로로 말의 문장부호 · 띄어쓰기, 섬이 접혀 있어도 옆 칸으로 펼쳐 열기, 관문을 넘은 뒤 대화 구분선의 단계 번호, 파일 탭의 닫기 × 자리, 흐름 보기에서 밀리던 보기 줄을 고쳤어요.
• 오류 고침. AI를 부를 때 서버가 죽던 것, 앱을 꺼도 맡긴 일이 남던 것, 기록이 빈 것으로 덮이던 것, 설정이 덮어써지던 것, 한글 조합 문제 등을 고쳤어요. 흔한 비밀값 모양도 더 가려요.

그 전에 바뀐 것 (11.0.0) — 작업실에서, 플로로와 함께 한 단계씩

• 켜면 바로 작업실이에요. 세 칸 — 왼쪽 대화 목록 · 파일, 가운데 탭(캔버스 · 퀘스트 · 책), 오른쪽 섬(플로로와 채팅). 섬은 접으면 작은 알약이 되고, 알약을 누르면 작업실이 다시 열려요. 설정은 머리 줄의 단추로 가운데에 열려요.
• 원하는 것을 말하면 1단계 초안부터. 플로로가 1단계를 초안으로 채우고 나는 칸마다 확인만 해요. 2 ~ 8단계도 앞 단계 결과로 초안을 만들고, 4 ~ 8단계는 칸마다 예시 셋 중에 골라요. 초안은 빠른 모델로 만들어요.
• 퀘스트 탭 하나. 노트북과 도전과제가 '퀘스트' 탭 하나가 됐어요 — 위에 여덟 장 지도, 아래에 지금 퀘스트 한 목록(지금 줄만 펼침). 흐름 · 문서 지도는 작업 칸 가득 보여요.
• 계획 → 맡기기 → 보고. 한 번에 붙여 넣은 글로 계획을 세우고 줄마다 맞아요 / 고칠래요. 확정한 줄을 내 Claude Code에 맡기면 기준마다 해냈는지 보고가 와요. 허락이 필요하면 섬에 카드가 뜨고, 멈추거나 막히면 다시 맡기기 · 직접 하기 · 그만두기를 골라요. 끝까지 못 갔으면 '오류 같이 보기'로 세 가지를 하나씩 묻고 다시 맡겨요.
• 파일을 작업실에서. 파일 칸에서 누르면 열려요 — md는 보기 좋게, 코드는 줄 번호. 고쳐 저장하고 되돌릴 수 있고, 비밀번호 모양이면 먼저 물어요. 문서를 고치는 일은 맡기기 틀로 넘겨요.
• 단계 문서를 내 GitHub에. 관문을 지나면 단계 문서 · 기획서 · 결정 기록을 작업 폴더에 쓰고, 커밋 · 푸시는 내 Claude Code가 해요(허락을 받고).
• 배운 것을 다음 프로젝트로. 관문마다 배운 것 한 줄, 완료 보고 뒤 한 장(생각 · 한 일 · 정한 것 · 배운 말 · 다음 할 일), 8단계에서 가져갈 것을 골라 다음 프로젝트의 그 단계에서 다시 봐요. 기록의 원본은 프로젝트 폴더예요 — 브라우저 기록이 없어도 폴더에서 되살려요. Floe가 읽지 않았으면 하는 폴더 · 파일은 설정 '기록' 탭에 적어요.
• 플로로와 자유 대화. 섬에서 편하게 말하면 플로로가 답하고, 대화로 채울 수 있는 칸을 '칸 n개에 적기'로 정리해 줘요. 대화는 프로젝트마다 이 컴퓨터에 남아요.
• 다른 AI로 넘기기. 섬의 '더 보기 → 다른 AI에 넘기기'가 지금 단계와 할 일을 복사할 글로 만들어요.
• 우리 색과 글꼴. 팀 웹사이트의 파스텔 색과 글꼴로 앱 전체를 맞췄어요.
• API 키가 거절되면 '연습용 예시로 둘러보기' 단추로 바로 연습 모드로 가요.
• 관문 계획서. 넘어가기 전 확인의 '계획서 보기' → 책 탭에 지금까지 한 것과 다음에 할 것이 한 권으로 — 목차를 누르면 그 절로 가고, 파일로도 받아요. 관문을 넘을 때마다 **버전(V.n)**이 하나 올라 README의 '버전 기록'에 남아요.
• 공부 묶음. 용어 풀이나 '아니요' 뒤 '더 공부하기' → 고른 것(단계 설명 · 계획서 · 용어 풀이 · 내 기록)을 파일 하나와 먼저 물을 질문 다섯으로 받아 내 NotebookLM에 직접 올려요. Floe는 보내지 않아요.
• 지식 창고로. 채택한 가져갈 것을 내 세컨드 브레인 폴더(SECOND_BRAIN_DATA)의 지식 문서로 넣어요 — 폴더를 정했을 때만, 덮어쓰지 않아요.
• 뺀 것: 명령 네 칸, 모아 보기 창, 위 줄의 '퀘스트' 단추, 칭호 · 기분 글, 접히기 전 테두리 빛, '작은 소리 내기'. 서재로 가는 단추는 대회 뒤까지 숨겨 두었어요.

그 전에 바뀐 것 (10.0.0) — 게임처럼, 플로로와 대화하며 퀘스트

• 섬이 플로로와 대화하는 곳이 됐어요. 위 줄 하나(집 · 단계 띠 · 조개 · 📜 · 모아 보기 · ⚙ · 핀 · 접기), 왼쪽에 큰 플로로(칭호 · 기분), 가운데 채팅(플로로 말 · 내 말 · 고르는 칩 · 입력 칸). 탭 넷 · 단추 넷 · LV/EXP · 명령 네 칸은 없어졌어요. 단계는 1단계부터 세요.
• 처음 실행: 무엇을 만들고 싶은지 말하면 "퀘스트를 시작하시겠습니까?" → 시작하면 퀘스트 창이 바로 떠서 1단계 받기 화면(참여 조건 · 할 일 · 기간 · REWARD · 큰 받기 단추, '고쳐 주세요'로 이름 · 개수 고침) → 받으면 공책(목차 · 줄) → 플로로가 한 줄씩 물어요 → 다 적으면 완료 보고 → 넘어가기 전 확인 → 무지개 조개 +1 · 칭호 → 다음 장. 진짜 AI 모드에서는 플로로가 퀘스트 설명 · 질문 · 예시를 만들어요.
• 창 셋. ⚙ 설정 창('○○ 님의 작업실' + 플로로 · 초기 개발자 → 중급자 → 상급자 · 서재로 가기 · 설정 창 자리 왼쪽/오른쪽 · 퀘스트 창 크기 · 이름 · 전부터 있던 설정)과 📜 퀘스트 창(설정 창의 반대쪽 — 퀘스트 · 도전과제(그림만, 마우스를 올리면 설명) · 서고)이 앱에서는 따로 뜨는 창이에요. 머리띠를 잡고 끌고, 퀘스트 창은 모서리나 S/M/L로 크기를 바꿔요. ×나 Esc로 닫아요.
• 뽑기 · 꾸미기. 위 줄의 조개나 설정 창 '조개 열기'로 뽑기 창 — 조개 셋에 한 번, 나올 확률은 늘 적혀 있고 돈으로 사는 건 없어요. 나온 것을 플로로가 바로 쓰고, 설정 창 꾸미기 줄에서 벗거나 바꿔요.
• 곁 퀘스트(만드는 크기를 키우면 할 일이 되는 것)가 공책 목차 아래 · 도전과제 옆 가지에 잠긴 채 보여요. Claude Code가 일하는 동안 채팅에 '일하고 있어요' 띠, 알림은 채팅에 한 줄. 서고 · 내 책 · 모아 보기 창의 단계 번호도 1~8.
• 알아 둘 것: 그림(이모지)은 자리표시예요(진짜 그림은 다음에). 휴대폰 폭은 전처럼 탭 둘. 판정 · 넘어가기 · 설계도 · 먹이 · 허락 카드 · 서고는 그대로예요.

그 전에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v11.2.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (11.2.0) — Claude Code와 더 매끄럽게, 플로로는 더 생생하게

• Claude Code가 일하는 동안 플로로가 노트북으로 코드를 쳐요. 일을 시작하면 노트북이 물에서 떠올라 열리고, 끝나면 닫혀 내려가요. 섬을 접어 둬도 알약의 얼굴이 바뀌어요.
• 표정이 자연스럽게 바뀌어요. 눈과 입은 스르르 뜨듯이, 머리 위 표시는 작게 솟아 나와요.
• Claude Code의 허락을 플로로가 자동으로 허용해요(새 기본값). 파일을 고치거나 명령을 쓸 때마다 묻지 않아요. 패키지 설치 · 외부 스크립트 실행도 묻지 않으니 알아 두세요. 지우기 · 강제 푸시 · 비밀값처럼 되돌리기 어려운 일은 계속 물어요. 설정 → 연결에서 끌 수 있어요.
• 장식이 머리에 붙어 같이 움직여요. 플로로 그림체로 다시 그렸고, 뽑는 순간 위에서 떨어져 머리가 살짝 눌려요.
• 옆 칸 섬의 입력 칸이 늘 보여요. 대화가 길어도 입력 칸은 그대로 있고 기록만 스크롤해요.
• 초안을 보는 중에 보낸 말이 칸에 바로 적히지 않아요. 물어보면 플로로가 답하고, 칸에는 내가 누른 것만 적혀요.
• '생각' 표정의 짝짝이 눈을 고쳤어요. 두 눈 다 평소 눈으로 위를 봐요.
• 작은 고침. 지도에서 번호 상자를 눌러도 퀘스트 카드가 올라오지 않아요. 8단계를 다 마친 뒤 Claude Code 알림이 끝난 상태를 풀지 않아요.

그 전에 바뀐 것 (11.1.0) — 11.0.0을 쓰며 걸린 것들을 고친 판

• 처음 설정을 마치면 바로 작업실의 플로로 홈이에요. 옛 섬 화면에서 '퀘스트' 단추를 찾지 않아도 돼요.
• 작업실은 늘 화면 가득 열려요. 저장된 작은 크기로 찌그러져 열리지 않아요. 열어 둔 동안 줄이거나 옮길 수 있고, 다음에 열면 다시 꽉 차요.
• 캔버스 탭을 뺐어요. 작업실의 첫 탭은 퀘스트예요.
• 스크롤바가 눈에 덜 띄어요. 섬과 작업실의 스크롤바를 숨기고, 작업 칸과 가운데 플로로 화면에만 얇고 옅은 막대가 있어요.
• 상자 보기(문서 지도)를 열면 지금 장으로 부드럽게 옮겨 가운데에 둬요. 작업실이 다시 그려져도 지도를 다시 불러오지 않고, 작은 칸을 가리던 띠와 단추는 숨겼어요.
• 책 탭의 README가 읽기 좋아졌어요. 마크다운 기호 대신 굵게 · 인용 · 표로 보여요.
• 작은 화면 고침. 플로로 말의 문장부호 · 띄어쓰기, 섬이 접혀 있어도 옆 칸으로 펼쳐 열기, 관문을 넘은 뒤 대화 구분선의 단계 번호, 파일 탭의 닫기 × 자리, 흐름 보기에서 밀리던 보기 줄을 고쳤어요.
• 오류 고침. AI를 부를 때 서버가 죽던 것, 앱을 꺼도 맡긴 일이 남던 것, 기록이 빈 것으로 덮이던 것, 설정이 덮어써지던 것, 한글 조합 문제 등을 고쳤어요. 흔한 비밀값 모양도 더 가려요.

그 전에 바뀐 것 (11.0.0) — 작업실에서, 플로로와 함께 한 단계씩

• 켜면 바로 작업실이에요. 세 칸 — 왼쪽 대화 목록 · 파일, 가운데 탭(캔버스 · 퀘스트 · 책), 오른쪽 섬(플로로와 채팅). 섬은 접으면 작은 알약이 되고, 알약을 누르면 작업실이 다시 열려요. 설정은 머리 줄의 단추로 가운데에 열려요.
• 원하는 것을 말하면 1단계 초안부터. 플로로가 1단계를 초안으로 채우고 나는 칸마다 확인만 해요. 2 ~ 8단계도 앞 단계 결과로 초안을 만들고, 4 ~ 8단계는 칸마다 예시 셋 중에 골라요. 초안은 빠른 모델로 만들어요.
• 퀘스트 탭 하나. 노트북과 도전과제가 '퀘스트' 탭 하나가 됐어요 — 위에 여덟 장 지도, 아래에 지금 퀘스트 한 목록(지금 줄만 펼침). 흐름 · 문서 지도는 작업 칸 가득 보여요.
• 계획 → 맡기기 → 보고. 한 번에 붙여 넣은 글로 계획을 세우고 줄마다 맞아요 / 고칠래요. 확정한 줄을 내 Claude Code에 맡기면 기준마다 해냈는지 보고가 와요. 허락이 필요하면 섬에 카드가 뜨고, 멈추거나 막히면 다시 맡기기 · 직접 하기 · 그만두기를 골라요. 끝까지 못 갔으면 '오류 같이 보기'로 세 가지를 하나씩 묻고 다시 맡겨요.
• 파일을 작업실에서. 파일 칸에서 누르면 열려요 — md는 보기 좋게, 코드는 줄 번호. 고쳐 저장하고 되돌릴 수 있고, 비밀번호 모양이면 먼저 물어요. 문서를 고치는 일은 맡기기 틀로 넘겨요.
• 단계 문서를 내 GitHub에. 관문을 지나면 단계 문서 · 기획서 · 결정 기록을 작업 폴더에 쓰고, 커밋 · 푸시는 내 Claude Code가 해요(허락을 받고).
• 배운 것을 다음 프로젝트로. 관문마다 배운 것 한 줄, 완료 보고 뒤 한 장(생각 · 한 일 · 정한 것 · 배운 말 · 다음 할 일), 8단계에서 가져갈 것을 골라 다음 프로젝트의 그 단계에서 다시 봐요. 기록의 원본은 프로젝트 폴더예요 — 브라우저 기록이 없어도 폴더에서 되살려요. Floe가 읽지 않았으면 하는 폴더 · 파일은 설정 '기록' 탭에 적어요.
• 플로로와 자유 대화. 섬에서 편하게 말하면 플로로가 답하고, 대화로 채울 수 있는 칸을 '칸 n개에 적기'로 정리해 줘요. 대화는 프로젝트마다 이 컴퓨터에 남아요.
• 다른 AI로 넘기기. 섬의 '더 보기 → 다른 AI에 넘기기'가 지금 단계와 할 일을 복사할 글로 만들어요.
• 우리 색과 글꼴. 팀 웹사이트의 파스텔 색과 글꼴로 앱 전체를 맞췄어요.
• API 키가 거절되면 '연습용 예시로 둘러보기' 단추로 바로 연습 모드로 가요.
• 관문 계획서. 넘어가기 전 확인의 '계획서 보기' → 책 탭에 지금까지 한 것과 다음에 할 것이 한 권으로 — 목차를 누르면 그 절로 가고, 파일로도 받아요. 관문을 넘을 때마다 **버전(V.n)**이 하나 올라 README의 '버전 기록'에 남아요.
• 공부 묶음. 용어 풀이나 '아니요' 뒤 '더 공부하기' → 고른 것(단계 설명 · 계획서 · 용어 풀이 · 내 기록)을 파일 하나와 먼저 물을 질문 다섯으로 받아 내 NotebookLM에 직접 올려요. Floe는 보내지 않아요.
• 지식 창고로. 채택한 가져갈 것을 내 세컨드 브레인 폴더(SECOND_BRAIN_DATA)의 지식 문서로 넣어요 — 폴더를 정했을 때만, 덮어쓰지 않아요.
• 뺀 것: 명령 네 칸, 모아 보기 창, 위 줄의 '퀘스트' 단추, 칭호 · 기분 글, 접히기 전 테두리 빛, '작은 소리 내기'. 서재로 가는 단추는 대회 뒤까지 숨겨 두었어요.

그 전에 바뀐 것 (10.0.0) — 게임처럼, 플로로와 대화하며 퀘스트

• 섬이 플로로와 대화하는 곳이 됐어요. 위 줄 하나(집 · 단계 띠 · 조개 · 📜 · 모아 보기 · ⚙ · 핀 · 접기), 왼쪽에 큰 플로로(칭호 · 기분), 가운데 채팅(플로로 말 · 내 말 · 고르는 칩 · 입력 칸). 탭 넷 · 단추 넷 · LV/EXP · 명령 네 칸은 없어졌어요. 단계는 1단계부터 세요.
• 처음 실행: 무엇을 만들고 싶은지 말하면 "퀘스트를 시작하시겠습니까?" → 시작하면 퀘스트 창이 바로 떠서 1단계 받기 화면(참여 조건 · 할 일 · 기간 · REWARD · 큰 받기 단추, '고쳐 주세요'로 이름 · 개수 고침) → 받으면 공책(목차 · 줄) → 플로로가 한 줄씩 물어요 → 다 적으면 완료 보고 → 넘어가기 전 확인 → 무지개 조개 +1 · 칭호 → 다음 장. 진짜 AI 모드에서는 플로로가 퀘스트 설명 · 질문 · 예시를 만들어요.
• 창 셋. ⚙ 설정 창('○○ 님의 작업실' + 플로로 · 초기 개발자 → 중급자 → 상급자 · 서재로 가기 · 설정 창 자리 왼쪽/오른쪽 · 퀘스트 창 크기 · 이름 · 전부터 있던 설정)과 📜 퀘스트 창(설정 창의 반대쪽 — 퀘스트 · 도전과제(그림만, 마우스를 올리면 설명) · 서고)이 앱에서는 따로 뜨는 창이에요. 머리띠를 잡고 끌고, 퀘스트 창은 모서리나 S/M/L로 크기를 바꿔요. ×나 Esc로 닫아요.
• 뽑기 · 꾸미기. 위 줄의 조개나 설정 창 '조개 열기'로 뽑기 창 — 조개 셋에 한 번, 나올 확률은 늘 적혀 있고 돈으로 사는 건 없어요. 나온 것을 플로로가 바로 쓰고, 설정 창 꾸미기 줄에서 벗거나 바꿔요.
• 곁 퀘스트(만드는 크기를 키우면 할 일이 되는 것)가 공책 목차 아래 · 도전과제 옆 가지에 잠긴 채 보여요. Claude Code가 일하는 동안 채팅에 '일하고 있어요' 띠, 알림은 채팅에 한 줄. 서고 · 내 책 · 모아 보기 창의 단계 번호도 1~8.
• 알아 둘 것: 그림(이모지)은 자리표시예요(진짜 그림은 다음에). 휴대폰 폭은 전처럼 탭 둘. 판정 · 넘어가기 · 설계도 · 먹이 · 허락 카드 · 서고는 그대로예요.

그 전에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v11.1.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (11.1.0) — 11.0.0을 쓰며 걸린 것들을 고친 판

• 처음 설정을 마치면 바로 작업실의 플로로 홈이에요. 옛 섬 화면에서 '퀘스트' 단추를 찾지 않아도 돼요.
• 작업실은 늘 화면 가득 열려요. 저장된 작은 크기로 찌그러져 열리지 않아요. 열어 둔 동안 줄이거나 옮길 수 있고, 다음에 열면 다시 꽉 차요.
• 캔버스 탭을 뺐어요. 작업실의 첫 탭은 퀘스트예요.
• 스크롤바가 눈에 덜 띄어요. 섬과 작업실의 스크롤바를 숨기고, 작업 칸과 가운데 플로로 화면에만 얇고 옅은 막대가 있어요.
• 상자 보기(문서 지도)를 열면 지금 장으로 부드럽게 옮겨 가운데에 둬요. 작업실이 다시 그려져도 지도를 다시 불러오지 않고, 작은 칸을 가리던 띠와 단추는 숨겼어요.
• 책 탭의 README가 읽기 좋아졌어요. 마크다운 기호 대신 굵게 · 인용 · 표로 보여요.
• 작은 화면 고침. 플로로 말의 문장부호 · 띄어쓰기, 섬이 접혀 있어도 옆 칸으로 펼쳐 열기, 관문을 넘은 뒤 대화 구분선의 단계 번호, 파일 탭의 닫기 × 자리, 흐름 보기에서 밀리던 보기 줄을 고쳤어요.
• 오류 고침. AI를 부를 때 서버가 죽던 것, 앱을 꺼도 맡긴 일이 남던 것, 기록이 빈 것으로 덮이던 것, 설정이 덮어써지던 것, 한글 조합 문제 등을 고쳤어요. 흔한 비밀값 모양도 더 가려요.

그 전에 바뀐 것 (11.0.0) — 작업실에서, 플로로와 함께 한 단계씩

• 켜면 바로 작업실이에요. 세 칸 — 왼쪽 대화 목록 · 파일, 가운데 탭(캔버스 · 퀘스트 · 책), 오른쪽 섬(플로로와 채팅). 섬은 접으면 작은 알약이 되고, 알약을 누르면 작업실이 다시 열려요. 설정은 머리 줄의 단추로 가운데에 열려요.
• 원하는 것을 말하면 1단계 초안부터. 플로로가 1단계를 초안으로 채우고 나는 칸마다 확인만 해요. 2 ~ 8단계도 앞 단계 결과로 초안을 만들고, 4 ~ 8단계는 칸마다 예시 셋 중에 골라요. 초안은 빠른 모델로 만들어요.
• 퀘스트 탭 하나. 노트북과 도전과제가 '퀘스트' 탭 하나가 됐어요 — 위에 여덟 장 지도, 아래에 지금 퀘스트 한 목록(지금 줄만 펼침). 흐름 · 문서 지도는 작업 칸 가득 보여요.
• 계획 → 맡기기 → 보고. 한 번에 붙여 넣은 글로 계획을 세우고 줄마다 맞아요 / 고칠래요. 확정한 줄을 내 Claude Code에 맡기면 기준마다 해냈는지 보고가 와요. 허락이 필요하면 섬에 카드가 뜨고, 멈추거나 막히면 다시 맡기기 · 직접 하기 · 그만두기를 골라요. 끝까지 못 갔으면 '오류 같이 보기'로 세 가지를 하나씩 묻고 다시 맡겨요.
• 파일을 작업실에서. 파일 칸에서 누르면 열려요 — md는 보기 좋게, 코드는 줄 번호. 고쳐 저장하고 되돌릴 수 있고, 비밀번호 모양이면 먼저 물어요. 문서를 고치는 일은 맡기기 틀로 넘겨요.
• 단계 문서를 내 GitHub에. 관문을 지나면 단계 문서 · 기획서 · 결정 기록을 작업 폴더에 쓰고, 커밋 · 푸시는 내 Claude Code가 해요(허락을 받고).
• 배운 것을 다음 프로젝트로. 관문마다 배운 것 한 줄, 완료 보고 뒤 한 장(생각 · 한 일 · 정한 것 · 배운 말 · 다음 할 일), 8단계에서 가져갈 것을 골라 다음 프로젝트의 그 단계에서 다시 봐요. 기록의 원본은 프로젝트 폴더예요 — 브라우저 기록이 없어도 폴더에서 되살려요. Floe가 읽지 않았으면 하는 폴더 · 파일은 설정 '기록' 탭에 적어요.
• 플로로와 자유 대화. 섬에서 편하게 말하면 플로로가 답하고, 대화로 채울 수 있는 칸을 '칸 n개에 적기'로 정리해 줘요. 대화는 프로젝트마다 이 컴퓨터에 남아요.
• 다른 AI로 넘기기. 섬의 '더 보기 → 다른 AI에 넘기기'가 지금 단계와 할 일을 복사할 글로 만들어요.
• 우리 색과 글꼴. 팀 웹사이트의 파스텔 색과 글꼴로 앱 전체를 맞췄어요.
• API 키가 거절되면 '연습용 예시로 둘러보기' 단추로 바로 연습 모드로 가요.
• 관문 계획서. 넘어가기 전 확인의 '계획서 보기' → 책 탭에 지금까지 한 것과 다음에 할 것이 한 권으로 — 목차를 누르면 그 절로 가고, 파일로도 받아요. 관문을 넘을 때마다 **버전(V.n)**이 하나 올라 README의 '버전 기록'에 남아요.
• 공부 묶음. 용어 풀이나 '아니요' 뒤 '더 공부하기' → 고른 것(단계 설명 · 계획서 · 용어 풀이 · 내 기록)을 파일 하나와 먼저 물을 질문 다섯으로 받아 내 NotebookLM에 직접 올려요. Floe는 보내지 않아요.
• 지식 창고로. 채택한 가져갈 것을 내 세컨드 브레인 폴더(SECOND_BRAIN_DATA)의 지식 문서로 넣어요 — 폴더를 정했을 때만, 덮어쓰지 않아요.
• 뺀 것: 명령 네 칸, 모아 보기 창, 위 줄의 '퀘스트' 단추, 칭호 · 기분 글, 접히기 전 테두리 빛, '작은 소리 내기'. 서재로 가는 단추는 대회 뒤까지 숨겨 두었어요.

그 전에 바뀐 것 (10.0.0) — 게임처럼, 플로로와 대화하며 퀘스트

• 섬이 플로로와 대화하는 곳이 됐어요. 위 줄 하나(집 · 단계 띠 · 조개 · 📜 · 모아 보기 · ⚙ · 핀 · 접기), 왼쪽에 큰 플로로(칭호 · 기분), 가운데 채팅(플로로 말 · 내 말 · 고르는 칩 · 입력 칸). 탭 넷 · 단추 넷 · LV/EXP · 명령 네 칸은 없어졌어요. 단계는 1단계부터 세요.
• 처음 실행: 무엇을 만들고 싶은지 말하면 "퀘스트를 시작하시겠습니까?" → 시작하면 퀘스트 창이 바로 떠서 1단계 받기 화면(참여 조건 · 할 일 · 기간 · REWARD · 큰 받기 단추, '고쳐 주세요'로 이름 · 개수 고침) → 받으면 공책(목차 · 줄) → 플로로가 한 줄씩 물어요 → 다 적으면 완료 보고 → 넘어가기 전 확인 → 무지개 조개 +1 · 칭호 → 다음 장. 진짜 AI 모드에서는 플로로가 퀘스트 설명 · 질문 · 예시를 만들어요.
• 창 셋. ⚙ 설정 창('○○ 님의 작업실' + 플로로 · 초기 개발자 → 중급자 → 상급자 · 서재로 가기 · 설정 창 자리 왼쪽/오른쪽 · 퀘스트 창 크기 · 이름 · 전부터 있던 설정)과 📜 퀘스트 창(설정 창의 반대쪽 — 퀘스트 · 도전과제(그림만, 마우스를 올리면 설명) · 서고)이 앱에서는 따로 뜨는 창이에요. 머리띠를 잡고 끌고, 퀘스트 창은 모서리나 S/M/L로 크기를 바꿔요. ×나 Esc로 닫아요.
• 뽑기 · 꾸미기. 위 줄의 조개나 설정 창 '조개 열기'로 뽑기 창 — 조개 셋에 한 번, 나올 확률은 늘 적혀 있고 돈으로 사는 건 없어요. 나온 것을 플로로가 바로 쓰고, 설정 창 꾸미기 줄에서 벗거나 바꿔요.
• 곁 퀘스트(만드는 크기를 키우면 할 일이 되는 것)가 공책 목차 아래 · 도전과제 옆 가지에 잠긴 채 보여요. Claude Code가 일하는 동안 채팅에 '일하고 있어요' 띠, 알림은 채팅에 한 줄. 서고 · 내 책 · 모아 보기 창의 단계 번호도 1~8.
• 알아 둘 것: 그림(이모지)은 자리표시예요(진짜 그림은 다음에). 휴대폰 폭은 전처럼 탭 둘. 판정 · 넘어가기 · 설계도 · 먹이 · 허락 카드 · 서고는 그대로예요.

그 전에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v11.0.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (11.0.0) — 작업실에서, 플로로와 함께 한 단계씩

• 켜면 바로 작업실이에요. 세 칸 — 왼쪽 대화 목록 · 파일, 가운데 탭(캔버스 · 퀘스트 · 책), 오른쪽 섬(플로로와 채팅). 섬은 접으면 작은 알약이 되고, 알약을 누르면 작업실이 다시 열려요. 설정은 머리 줄의 단추로 가운데에 열려요.
• 원하는 것을 말하면 1단계 초안부터. 플로로가 1단계를 초안으로 채우고 나는 칸마다 확인만 해요. 2 ~ 8단계도 앞 단계 결과로 초안을 만들고, 4 ~ 8단계는 칸마다 예시 셋 중에 골라요. 초안은 빠른 모델로 만들어요.
• 퀘스트 탭 하나. 노트북과 도전과제가 '퀘스트' 탭 하나가 됐어요 — 위에 여덟 장 지도, 아래에 지금 퀘스트 한 목록(지금 줄만 펼침). 흐름 · 문서 지도는 작업 칸 가득 보여요.
• 계획 → 맡기기 → 보고. 한 번에 붙여 넣은 글로 계획을 세우고 줄마다 맞아요 / 고칠래요. 확정한 줄을 내 Claude Code에 맡기면 기준마다 해냈는지 보고가 와요. 허락이 필요하면 섬에 카드가 뜨고, 멈추거나 막히면 다시 맡기기 · 직접 하기 · 그만두기를 골라요. 끝까지 못 갔으면 '오류 같이 보기'로 세 가지를 하나씩 묻고 다시 맡겨요.
• 파일을 작업실에서. 파일 칸에서 누르면 열려요 — md는 보기 좋게, 코드는 줄 번호. 고쳐 저장하고 되돌릴 수 있고, 비밀번호 모양이면 먼저 물어요. 문서를 고치는 일은 맡기기 틀로 넘겨요.
• 단계 문서를 내 GitHub에. 관문을 지나면 단계 문서 · 기획서 · 결정 기록을 작업 폴더에 쓰고, 커밋 · 푸시는 내 Claude Code가 해요(허락을 받고).
• 배운 것을 다음 프로젝트로. 관문마다 배운 것 한 줄, 완료 보고 뒤 한 장(생각 · 한 일 · 정한 것 · 배운 말 · 다음 할 일), 8단계에서 가져갈 것을 골라 다음 프로젝트의 그 단계에서 다시 봐요. 기록의 원본은 프로젝트 폴더예요 — 브라우저 기록이 없어도 폴더에서 되살려요. Floe가 읽지 않았으면 하는 폴더 · 파일은 설정 '기록' 탭에 적어요.
• 플로로와 자유 대화. 섬에서 편하게 말하면 플로로가 답하고, 대화로 채울 수 있는 칸을 '칸 n개에 적기'로 정리해 줘요. 대화는 프로젝트마다 이 컴퓨터에 남아요.
• 다른 AI로 넘기기. 섬의 '더 보기 → 다른 AI에 넘기기'가 지금 단계와 할 일을 복사할 글로 만들어요.
• 우리 색과 글꼴. 팀 웹사이트의 파스텔 색과 글꼴로 앱 전체를 맞췄어요.
• API 키가 거절되면 '연습용 예시로 둘러보기' 단추로 바로 연습 모드로 가요.
• 관문 계획서. 넘어가기 전 확인의 '계획서 보기' → 책 탭에 지금까지 한 것과 다음에 할 것이 한 권으로 — 목차를 누르면 그 절로 가고, 파일로도 받아요. 관문을 넘을 때마다 **버전(V.n)**이 하나 올라 README의 '버전 기록'에 남아요.
• 공부 묶음. 용어 풀이나 '아니요' 뒤 '더 공부하기' → 고른 것(단계 설명 · 계획서 · 용어 풀이 · 내 기록)을 파일 하나와 먼저 물을 질문 다섯으로 받아 내 NotebookLM에 직접 올려요. Floe는 보내지 않아요.
• 지식 창고로. 채택한 가져갈 것을 내 세컨드 브레인 폴더(SECOND_BRAIN_DATA)의 지식 문서로 넣어요 — 폴더를 정했을 때만, 덮어쓰지 않아요.
• 뺀 것: 명령 네 칸, 모아 보기 창, 위 줄의 '퀘스트' 단추, 칭호 · 기분 글, 접히기 전 테두리 빛, '작은 소리 내기'. 서재로 가는 단추는 대회 뒤까지 숨겨 두었어요.

그 전에 바뀐 것 (10.0.0) — 게임처럼, 플로로와 대화하며 퀘스트

• 섬이 플로로와 대화하는 곳이 됐어요. 위 줄 하나(집 · 단계 띠 · 조개 · 📜 · 모아 보기 · ⚙ · 핀 · 접기), 왼쪽에 큰 플로로(칭호 · 기분), 가운데 채팅(플로로 말 · 내 말 · 고르는 칩 · 입력 칸). 탭 넷 · 단추 넷 · LV/EXP · 명령 네 칸은 없어졌어요. 단계는 1단계부터 세요.
• 처음 실행: 무엇을 만들고 싶은지 말하면 "퀘스트를 시작하시겠습니까?" → 시작하면 퀘스트 창이 바로 떠서 1단계 받기 화면(참여 조건 · 할 일 · 기간 · REWARD · 큰 받기 단추, '고쳐 주세요'로 이름 · 개수 고침) → 받으면 공책(목차 · 줄) → 플로로가 한 줄씩 물어요 → 다 적으면 완료 보고 → 넘어가기 전 확인 → 무지개 조개 +1 · 칭호 → 다음 장. 진짜 AI 모드에서는 플로로가 퀘스트 설명 · 질문 · 예시를 만들어요.
• 창 셋. ⚙ 설정 창('○○ 님의 작업실' + 플로로 · 초기 개발자 → 중급자 → 상급자 · 서재로 가기 · 설정 창 자리 왼쪽/오른쪽 · 퀘스트 창 크기 · 이름 · 전부터 있던 설정)과 📜 퀘스트 창(설정 창의 반대쪽 — 퀘스트 · 도전과제(그림만, 마우스를 올리면 설명) · 서고)이 앱에서는 따로 뜨는 창이에요. 머리띠를 잡고 끌고, 퀘스트 창은 모서리나 S/M/L로 크기를 바꿔요. ×나 Esc로 닫아요.
• 뽑기 · 꾸미기. 위 줄의 조개나 설정 창 '조개 열기'로 뽑기 창 — 조개 셋에 한 번, 나올 확률은 늘 적혀 있고 돈으로 사는 건 없어요. 나온 것을 플로로가 바로 쓰고, 설정 창 꾸미기 줄에서 벗거나 바꿔요.
• 곁 퀘스트(만드는 크기를 키우면 할 일이 되는 것)가 공책 목차 아래 · 도전과제 옆 가지에 잠긴 채 보여요. Claude Code가 일하는 동안 채팅에 '일하고 있어요' 띠, 알림은 채팅에 한 줄. 서고 · 내 책 · 모아 보기 창의 단계 번호도 1~8.
• 알아 둘 것: 그림(이모지)은 자리표시예요(진짜 그림은 다음에). 휴대폰 폭은 전처럼 탭 둘. 판정 · 넘어가기 · 설계도 · 먹이 · 허락 카드 · 서고는 그대로예요.

그 전에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v10.0.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (10.0.0) — 게임처럼, 플로로와 대화하며 퀘스트

• 섬이 플로로와 대화하는 곳이 됐어요. 위 줄 하나(집 · 단계 띠 · 조개 · 📜 · 모아 보기 · ⚙ · 핀 · 접기), 왼쪽에 큰 플로로(칭호 · 기분), 가운데 채팅(플로로 말 · 내 말 · 고르는 칩 · 입력 칸). 탭 넷 · 단추 넷 · LV/EXP · 명령 네 칸은 없어졌어요. 단계는 1단계부터 세요.
• 처음 실행: 무엇을 만들고 싶은지 말하면 "퀘스트를 시작하시겠습니까?" → 시작하면 퀘스트 창이 바로 떠서 1단계 받기 화면(참여 조건 · 할 일 · 기간 · REWARD · 큰 받기 단추, '고쳐 주세요'로 이름 · 개수 고침) → 받으면 공책(목차 · 줄) → 플로로가 한 줄씩 물어요 → 다 적으면 완료 보고 → 넘어가기 전 확인 → 무지개 조개 +1 · 칭호 → 다음 장. 진짜 AI 모드에서는 플로로가 퀘스트 설명 · 질문 · 예시를 만들어요.
• 창 셋. ⚙ 설정 창('○○ 님의 작업실' + 플로로 · 초기 개발자 → 중급자 → 상급자 · 서재로 가기 · 설정 창 자리 왼쪽/오른쪽 · 퀘스트 창 크기 · 이름 · 전부터 있던 설정)과 📜 퀘스트 창(설정 창의 반대쪽 — 퀘스트 · 도전과제(그림만, 마우스를 올리면 설명) · 서고)이 앱에서는 따로 뜨는 창이에요. 머리띠를 잡고 끌고, 퀘스트 창은 모서리나 S/M/L로 크기를 바꿔요. ×나 Esc로 닫아요.
• 뽑기 · 꾸미기. 위 줄의 조개나 설정 창 '조개 열기'로 뽑기 창 — 조개 셋에 한 번, 나올 확률은 늘 적혀 있고 돈으로 사는 건 없어요. 나온 것을 플로로가 바로 쓰고, 설정 창 꾸미기 줄에서 벗거나 바꿔요.
• 곁 퀘스트(만드는 크기를 키우면 할 일이 되는 것)가 공책 목차 아래 · 도전과제 옆 가지에 잠긴 채 보여요. Claude Code가 일하는 동안 채팅에 '일하고 있어요' 띠, 알림은 채팅에 한 줄. 서고 · 내 책 · 모아 보기 창의 단계 번호도 1~8.
• 알아 둘 것: 그림(이모지)은 자리표시예요(진짜 그림은 다음에). 휴대폰 폭은 전처럼 탭 둘. 판정 · 넘어가기 · 설계도 · 먹이 · 허락 카드 · 서고는 그대로예요.

그 전에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v9.0.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (9.0.0)

• 받은 앱이 열려요(Mac). 앱 전체에 간이 서명을 하고 묶어요 — 처음 열 때 '시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기'로 열리는지 확인 중이에요(안 되면 아래 xattr 한 줄). dmg 창에 '응용 프로그램으로 끌어 놓으세요'가 보여요. Floe는 한 번에 하나만 켜져요 — 옛 것을 먼저 끄세요.
• 할 일을 적으면 Claude Code에 넘겨요. AI 진행 판에 할 일을 적고 '요구 문장으로 정리' → 고쳐서 '허락하고 넘기기'. Claude Code가 파일을 고치거나 명령을 쓰기 전에 허락을 구하면 섬에 승인 카드가 떠요 — 허용 · 거절은 누른 대로, 되돌리기 어려운 일은 한 번 더 물어요. 답이 늦거나 Floe가 꺼져 있으면 대신 허용하지 않고 Claude Code가 스스로 물어요. 프로젝트 폴더를 한 번 다시 연결해 주세요(허락 훅이 새로 걸려요).
• 먹이에 종류를 붙여요. 먹는 구간마다 요구 · 결정 · 배운 것 · 할 일 · 참고 중 하나를 고르고, 확인하면 도서관 탭 맨 위 '확인할 먹이'에 모여요. '맞아요'를 누르면 그 종류로 내 책의 칸에 들어가요.
• 파일을 끌고 오면 파란 먹이 층("플로로에게 먹이를 주세요" + 폴더 안 물고기)이 떠요. 먹이를 검사하는 동안은 다른 일을, 살펴보는 동안은 먹이를 받지 않아요 — 플로로가 까닭을 말하고 화난 눈으로 X 표지판을 들어요.
• 서고의 책장은 내가 만들어요. 처음엔 '분류 안 함' 하나. '+ 책장 만들기'로 늘리고, 펼친 책에서 책장을 고르고, 이름을 바꾸거나 지워요(지우면 책은 '분류 안 함'으로). 떠 있던 배운 말 표와 책을 잇는 선은 뺐어요.
• 책 보기 설정 — 책 화면의 '보기 설정'에서 구조(간결 · 탭), 칸 켜기/끄기, 보기(책별 · 세션별), 크기(짧게 · 전체 화면). 섬과 서고가 같은 설정을 써요.
• 접히기까지의 시간을 설정에서 5 · 10 · 15 · 30 · 60초로 고르고, 아래 게이지바 대신 테두리 빛이 위에서 양쪽으로 내려와 아래에서 만나면 접혀요.
• 넘어가기 전 확인에서 네 / 아니요를 물을 때 밖의 칸이 둘이 돼요(1 · 2 키).
• 섬이 펼쳐지고 접힐 때 옆으로 밀리지 않아요(기준점을 섬의 위 가운데 하나로). 노치 Mac의 띠 바탕이 투명이에요. 말풍선 따라가기 · 경험치 막대를 가볍게 했어요.

그 전에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. Mac: 켜진 Floe를 끄고(Cmd+Q) → dmg에서 Floe를 '응용 프로그램'으로 끌어 놓고(물으면 '대치') → 엽니다. 9.0.0부터 간이 서명이라 '확인되지 않은 개발자' 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '그래도 열기'(사람 확인 전 — F-41). 그래도 막히면 터미널에서 xattr -dr com.apple.quarantine /Applications/Floe.app 뒤 다시 엽니다(macOS 15부터 우클릭 → 열기는 없습니다). Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v8.1.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (8.1.0)

• 플로로에게 먹이를 줘요. 처음 화면이 '먹이 주기'예요 — 글 파일(.md · .txt)을 섬에 끌어다 놓거나 글을 붙여 넣으면 플로로가 구간으로 나눠 주제를 보여 주고, 비밀번호 같은 구간은 "못 먹어요", 개인적인 일 같은 구간은 "안 먹을게요"로 빼요. 구간마다 바꿀 수 있고, 확인하면 빠진 구간 없이 어디쯤인지 봐요. 빠진 구간의 글은 AI에게도 책에도 가지 않아요. 서버 없이는 '예시 먹이 주기'로 같은 흐름을 봐요.
• '설계도' 탭이 없어졌어요. 단계마다 만드는 문서(아이디어 정리표 · 꼭 필요한 기능 목록 · 방법을 고른 기록 · 작은 할 일 목록)는 도서관의 책 안에서 열어요 — 책에 들어가 '단계 문서'에서 하나를 고르면 그 자리에서 초안 받기 → 고치기 → 다시 봐 주세요 → 확정. 받은 먹이도 책에 남아요. 이번 단계 카드의 '살피기'에도 책으로 가는 길이 있어요.
• 화면에서 '설계도'라는 말을 뺐어요. 단계 문서 · 문서로 부릅니다.
• 한 줄로 접혀 있을 때 플로로의 말이 잘리지 않아요. 말하는 동안만 창이 말풍선 아래까지 늘었다가 줄어요(가로는 그대로).
• 그사이 들어온 것(8.0.0 뒤): 켜면 기본 화면(바이브 코딩 · 서재 · 알림 · AI 진행 단추, 알림 · AI 진행은 섬 안에서 바로, 집 단추로 돌아옴) · 섬이 접히고 펼쳐질 때 늘고 줄어들고 한 줄에 마우스를 올리면 살짝 커져요 · 서고 전환이 가벼워졌어요 · 서고에 다녀와도 떠난 화면으로 돌아와요 · Windows에서 처음 설정이 작게 끼던 것을 고쳤어요.

그 전에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.

2. Mac — 이렇게 여세요(2026-10-20 고침). 8.1.0은 앱 서명이 깨진 채 묶여, 브라우저로 받으면 macOS가 '손상된 앱'으로 막습니다. macOS 15부터는 우클릭 → 열기도 없습니다. 다음 버전에서 고칩니다.

   1. 켜져 있는 Floe를 끕니다 — 메뉴 Floe → Floe 끄기(Cmd+Q). 옛 버전이 켜져 있으면 새 버전을 열어도 옛 것이 나옵니다.
   2. dmg를 열고 Floe를 '응용 프로그램' 폴더로 끌어 놓습니다(물으면 '대치'). dmg 창 안에서 바로 열지 않습니다.
   3. 터미널에서 한 줄: xattr -dr com.apple.quarantine /Applications/Floe.app — 인터넷에서 받았다는 표시만 뗍니다.
   4. 응용 프로그램에서 Floe를 엽니다.

   Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.

3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.

4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).

5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v8.0.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

이번에 바뀐 것 (8.0.0)

• 켤 때 플로로가 인사해요. 띠의 물결 선이 켜지고(노치가 있는 Mac은 노치 자리에서) 플로로가 물 위로 나와 지느러미를 흔들어요. 누르거나 아무 키를 누르면 바로 넘어가요. 움직임 줄이기 설정이면 움직이지 않아요. 서버가 켜지는 동안도 빈 화면 대신 물결 선이 보여요.
• 모아 보기 창이 생겼어요. 메뉴 Floe → 모아 보기 열기, 트레이, Dock, 섬 위쪽 줄의 단추로 열어요. 왼쪽에 세 공간이 있어요.
  • 바이브 코딩 — 할 일(바이브 코딩 · 서재)을 골라 들어가요.
  • 알림 — AI 코딩 도구가 보낸 알림 기록이에요. 섬의 기록과 같아요.
  • AI 진행 — Claude Code가 읽고 · 고치고 · 실행한 것을 한 줄씩 보여요. 파일 내용과 명령 결과는 받지 않고, 이 컴퓨터 밖으로 보내지 않아요.
• 서재를 오갈 때 물속으로. 서고로 들어갈 때 플로로가 섬 한가운데에서 잠수하고, 서재에서 ← 작업 화면으로를 누르면 물이 차오른 뒤 작업 화면이 물속에서 떠올라요. 들어갈 때 걸리던 시간을 반으로 줄였어요.
• 서재에서는 창을 끌어 크기를 바꿀 수 있어요. 돌아오면 섬 크기로 돌아가고, 바꾼 크기는 다음에 들어갈 때 그대로예요(앱을 끄기 전까지). 플로로 크기는 창 크기를 따라요.
• 그사이 들어온 것: Mac 노치 자리에 섬이 붙어요(7.x) · 창 밖 커서를 따라올 때 눈이 부드럽게 움직여요.
• 전에 프로젝트 폴더를 연결했다면 한 번 다시 연결해 주세요(Floe → 프로젝트 폴더 연결…). AI 진행이 쓰는 훅이 새로 걸려요.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. 서명이 없어 처음엔 경고가 뜹니다 → Mac은 Finder에서 우클릭 → 열기, Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v7.0.0

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. 서명이 없어 처음엔 경고가 뜹니다 → Mac은 Finder에서 우클릭 → 열기, Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.

Floe 앱 알파 — app-v6.2.0 (설정은 섬 옆 · 서고로 가면 창 넓어짐 · Mac arm64 + 우분투 · Windows는 병합 뒤 CI)

Floe 오버레이 앱 — 알파

코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.

받아서 쓰는 법

1. Mac(Apple Silicon)은 Floe-<버전>-arm64.dmg, Windows는 Floe-Setup-<버전>.exe, 우분투 Linux는 Floe-<버전>-x86_64.AppImage(또는 Floe-<버전>-amd64.deb, ARM 컴퓨터는 -arm64)를 받습니다.
2. 서명이 없어 처음엔 경고가 뜹니다 → Mac은 Finder에서 우클릭 → 열기, Windows는 "추가 정보 → 실행". 우분투 AppImage는 chmod +x 뒤 실행(FUSE가 없다고 하면 sudo apt install libfuse2t64), deb는 sudo apt install ./Floe-*.deb.
3. 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
4. 내 키로 쓰려면 Floe → 설정 폴더 열기에 .env(모양은 03-backend/navigator/.env.example).
5. 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.

알아 둘 것

• 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
• 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
• 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.