Repository navigation
Floe 앱 알파 — app-v9.0.0
Pre-release
Pre-release
·
936 commits
to main
since this release
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 진행이 쓰는 훅이 새로 걸려요.
받아서 쓰는 법
- Mac(Apple Silicon)은
Floe-<버전>-arm64.dmg, Windows는Floe-Setup-<버전>.exe, 우분투 Linux는Floe-<버전>-x86_64.AppImage(또는Floe-<버전>-amd64.deb, ARM 컴퓨터는-arm64)를 받습니다. - 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. - 메뉴 Floe → 프로젝트 폴더 연결…(Windows · 우분투는 창 우클릭 또는 트레이의 Floe 아이콘) 으로 지금 만드는 폴더를 고르고, 그 폴더에서 Claude Code를 새로 엽니다. 플로로가 작업을 알아챕니다.
- 내 키로 쓰려면 Floe → 설정 폴더 열기에
.env(모양은03-backend/navigator/.env.example). - 끄기: Floe → Floe 끄기. 느낀 점은 톱니 → 느낀 점 → Jira용 복사.
알아 둘 것
- 앱은 늘 자기 서버를 켭니다(4317이 막혀 있으면 옆 포트). 터미널의 Floe 서버와는 별개입니다.
- 새 버전은 메뉴 Floe → 새 버전 확인이 여는 Releases에서 받습니다(앱 안 자동 업데이트는 아직).
- 사람이 써 본 기록이 적습니다. 걸리는 게 있으면 앱 안 '느낀 점'에 남기거나 Jira 프로젝트 Floe에 적어 주세요.