Repository navigation
Floe 앱 알파 — app-v8.0.0
Pre-release
Pre-release
·
1006 commits
to main
since this release
Floe 오버레이 앱 — 알파
코딩 도구 위에 항상 위로 뜨는 Floe. 화면과 서버가 그대로 들어 있고, AI는 이 컴퓨터의 Claude Code 로그인(또는 내 .env 키)을 씁니다. 무엇이 바뀌었는지는 저장소의 CHANGELOG.md 맨 위 줄.
이번에 바뀐 것 (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은 Finder에서 우클릭 → 열기, 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에 적어 주세요.