Skip to content

Floe 앱 알파 — app-v8.1.0

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 20 Oct 00:30
· 971 commits to main since this release
3ebca27

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에 적어 주세요.