Skip to content

slnu21/Reflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reflow

인터럽트 직전의 작업 맥락을 찍어두고, 돌아왔을 때 다시 흐름(flow)에 빠르게 올라타게 해주는 Windows 데스크톱 도구.

Platform .NET release

왜 만들었나

개발·아키텍처처럼 긴 몰입이 필요한 일은 회의·외근·동료 질문에 끊기기 마련입니다. 그런데 진짜 비용은 인터럽트 그 자체가 아니라 다시 돌아왔을 때 "내가 아까 뭐 하고 있었지?"를 복원하는 몇 분입니다.

Reflow는 인터럽트 직전의 작업 상태 — 어떤 브랜치에서 무슨 파일을 어떻게 고치고 있었는지, 방금 친 명령, 다음에 하려던 것 — 를 한 번의 클릭/단축키로 스냅샷해 둡니다. 돌아오면 그 스냅샷을 복귀 카드로 펼쳐 10초 안에 흐름을 되찾습니다.

차별점은 내보내기입니다. 캡처한 원시 컨텍스트를 사람·AI 모두 읽기 좋은 .md/.html 문서로 떨궈, Claude Code 같은 에이전틱 도구에 그대로 붙여넣어 "이어서 작업"을 위임할 수 있습니다. 기본 동작은 LLM 호출 없이(비용 0) 문서로 내보내는 것이고, AI 요약은 선택입니다.

주요 기능

  • ⌨️ 빠른 캡처 — 전역 단축키 Ctrl+Alt+S 또는 떠다니는 위젯 클릭으로 즉시 스냅샷
  • 🔍 자동 컨텍스트 수집 — git(브랜치·diff·변경 파일) · 최근 PowerShell 명령 · 활성 창 제목 · 최근 수정 파일
  • 📤 복귀 카드 내보내기.md / .html 파일 또는 클립보드로 → 에이전틱 도구에 바로 전달
  • 🟢 떠다니는 캐릭터 위젯 — 상태(대기/방금 찍음/복귀 중)별 이미지·말풍선, 항상 위·드래그 이동
  • 🤖 선택적 AI 요약ANTHROPIC_API_KEY 설정 시 "어디까지 했고 다음은 무엇" 요약 (기본 비활성)

다운로드 & 실행

가장 쉬운 방법 — 빌드 없이 바로 실행:

  1. Releases에서 Reflow.exe 다운로드
  2. 더블클릭으로 실행

자체 포함(self-contained) 빌드라 별도 .NET 설치가 필요 없습니다. 실행하면 시스템 트레이에 상주하고 화면에 캐릭터 위젯이 뜹니다.

  • 요구 사항: Windows 10/11 (x64)
  • (선택) git이 PATH에 있으면 git 컨텍스트(브랜치·diff·변경 파일)까지 수집합니다.
  • 처음 실행 시 SmartScreen 경고가 뜨면 "추가 정보 → 실행"으로 진행하세요(서명되지 않은 바이너리).

소스에서 빌드 (개발자용)

git clone https://github.com/sinwoo0225/Reflow.git
cd Reflow

dotnet build Reflow.sln
dotnet run --project src/Reflow.App
  • 요구 사항: .NET 8 SDK (global.json8.0.420으로 고정)
  • 단일 파일로 다시 패키징하려면:
    dotnet publish src/Reflow.App -c Release -r win-x64 --self-contained `
      -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

사용법

1) 워치할 프로젝트 등록

트레이 아이콘 우클릭 → 설정 → "워치 대상 프로젝트 폴더"에 git 저장소 경로를 한 줄에 하나씩 입력. 스냅샷 시 가장 최근에 수정된 폴더가 자동으로 선택됩니다.

2) 스냅샷 찍기

작업 도중 인터럽트가 오면:

  • Ctrl+Alt+S 누르거나 위젯 좌클릭
  • 뜨는 팝업에 "다음에 하려던 것" 한 줄 메모(선택) 입력 → 저장

위젯은 클릭해도 포커스를 빼앗지 않으므로, 직전에 작업하던 창이 그대로 "활성 창"으로 기록됩니다.

3) 복귀하기

  • 트레이 메뉴(또는 위젯 우클릭) → 스냅샷 목록 / 복귀
  • 스냅샷을 고르면 경과 시간·브랜치·변경 파일·최근 명령·메모가 담긴 복귀 카드가 보입니다.
  • 버튼으로 활용:
    • 클립보드 복사 → Claude Code 등에 붙여넣어 이어서 작업
    • MD / HTML 내보내기%AppData%\Reflow\exports\에 저장 후 열림
    • LLM 요약 (API 키 설정 시에만 노출)

위젯 조작 요약

동작 결과
좌클릭 스냅샷 캡처
드래그 위치 이동 (재시작 후에도 유지)
우클릭 메뉴 (스냅샷 / 목록·복귀 / 설정 / 숨김 / 종료)
마우스 올리기 "마지막 스냅샷: N분 전" 말풍선

캐릭터 이미지 변경

위젯 캐릭터는 캡처 상태별로 다른 이미지를 보여줍니다. 원하는 PNG로 바꿀 수 있습니다.

  1. 트레이 아이콘(또는 위젯) 우클릭 → 설정
  2. "캐릭터 위젯" 항목에서 상태별 이미지 경로를 찾기로 지정
    • Idle (대기) · Captured (방금 찍음) · Resuming (목록/복귀 중)
  3. 저장하면 즉시 반영됩니다. 경로를 비우면 기본 이모지(🙂 / 📸 / 📖)로 표시됩니다.

권장 사양: 정사각형 · 투명 배경 PNG · 144–256px. (위젯 크기도 설정에서 40–240px로 조절)

예시 캐릭터 제공 — 저장소 images/icons/에 고양이·강아지 세트가 들어 있습니다. 상태에 맞게 지정하세요:

상태 고양이 강아지
Idle cat-idle-256.png pup-idle-256.png
Captured cat-captured-256.png pup-captured-256.png
Resuming cat-list-256.png pup-list-256.png

파일명의 listResuming 상태에 해당합니다. 설정 파일을 직접 편집하려면 %AppData%\Reflow\settings.jsonCharacterImages상태명: 경로를 넣어도 됩니다.

설정 & 데이터 위치

모든 데이터는 로컬에만 저장됩니다: %AppData%\Reflow\

  • snapshots.json — 스냅샷 기록
  • settings.json — 워치 프로젝트, 위젯 옵션 등
  • exports/ — 내보낸 복귀 카드(.md/.html)

프로젝트 구조

src/Reflow.Core   # 모델·수집기·저장·내보내기·LLM·서비스 (UI 무관)
src/Reflow.App    # WPF 트레이앱 (Widget / Views / Services)

코드 규칙: 파일당 top-level 타입 1개, 네임스페이스 = 폴더 경로.

로드맵

  • Visual Studio 확장(VSIX) 연동 — 열린 탭·커서 위치까지 캡처
  • 집중 신호 위젯이 회의/인터럽트 상태로 바뀔 때 자동 스냅샷
  • 멀티 프로젝트 타임라인 / 검색

라이선스

MIT License © 2026 sinwoo0225

About

No description, website, or topics provided.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages