바이브 코딩을 하며 프로젝트 주도권을 잡기 위해 도구를 만들었습니다.

안녕하세요? 1인 개발을 하고 있는 비치콤버 입니다.

코드는 계속 바뀌는데 뭐가 왜 바뀌었는지 며칠 지나면 기억이 안 나고, 처음에 세운 계획은 에이전트랑 몇 번 핑퐁 치다 보면 어디로 샜는지 모르게 됩니다. AI는 분 단위로 일하는데, 정작 이 프로젝트가 지금 어디까지 왔고 다음에 뭘 해야 하는지는 점점 흐려진다고 느꼈습니다.

그래서 만들었습니다. 바이브 코딩하면서 코드 변화랑 계획을 사람이 관리하는 로컬 도구입니다. 두 축으로 봅니다.

1. 코드가 어떻게 바뀌는지

에이전트가 작업을 끝낼 때마다 규칙(AGENTS.md)대로 작업 일지를 마크다운으로 한 장씩 남깁니다. 버그/기능/리팩토링/에러/잡일로 알아서 분류되고요. 변경된 파일은 네트워크 없이 로컬 diff로 바로 비교돼서, "고쳤습니다" 하고 넘어온 게 진짜 고쳐졌는지 1차로 거를 수 있습니다. 일지별 diff는 그 시점 그대로 박제됩니다.

2. 계획이 어떻게 굴러가는지

Planner가 goal → 서브태스크 → 작업 일지 3단으로 묶여 있습니다. AI가 방금 친 작업이 어떤 목표에 달린 일인지 위로 연결되니까, 분 단위로 흩어지는 작업을 주단위 목표에 다시 붙일 수 있습니다. 오늘 뭐가 바뀌고 어제 뭘 끝냈고 다음이 뭔지는 Today 화면에서 실시간으로 모입니다.

정리하면 에이전트는 코드를 짜고, 나는 변화랑 계획만 본다. 이게 목표였습니다.

몇가지 특징이 있는데,

로컬 우선. 일지는 그냥 markdown, 데이터는 전부 프로젝트 .oculpm/ + 로컬 SQLite에 있습니다. 서버로 나가는 거 없습니다 (애초에 서버가 없어요).
계정·텔레메트리 다 없습니다.
git 친화. 파일이라 git clone으로 그대로 옮겨가도 동작합니다. 앱이 망해도 데이터는 남습니다.
Electron 아니고 Tauri 2 네이티브라 콜드 스타트 1.5초 안쪽입니다.
아직 macOS 애플 실리콘만 됩니다. 인텔맥과 윈도우는 작업 중이에요. 공증 전 빌드라 처음 열 때 손상됐다고 뜰텐데 설정 → 개인정보 보호 및 보안에서 허용해주셔야 앱 실행이 가능합니다.(애플 서명이 너무 비싸요..ㅜ)

실행 화면

약 일주일간 제가 직접 사용하며 작업한 사진입니다.

1. 프로젝트 Today

프로젝트 폴더 하나 선택하시고 작업하시게 되면 처음 보여지는 페이지입니다.

2. 날짜별 작업 일지.

매일 타임라인 순으로 작업 내용이 기록되어 있고 작업을 날짜별로도 보실 수 있습니다.

3. 특정 작업 일지

이건 특정 작업을 작업 일지에서 클릭 시 보실 수 있는 작업에 관한 기록입니다. (코드는 보여져도 무관한 파일로 보여드리니 괜찮습니다)

4. 작업 플래너

사용자가 하고자 하는 일들을 플래너로 계획을 세우고 AI가 작업이 완료 되었을 때 수정하며 전척도를 볼 수 있습니다. 완료된 플랜은 잠금하여 수정을 막을 수도 있고, 플랜들을 여러개 새워서 분리하실수도 있습니다.

마지막으로 만들면서 제가 제일 신경 쓴 부분이라 미리 답하면 인덱싱, 시맨틱 검색, 변경 diff, 통계는 전부 로컬에서 돕니다.

임베딩 모델(~135MB)도 처음 한 번만 받아서 온디바이스로 굴러가니까, 검색 한 번 한다고 외부 API에 토큰이 나가는 구조가 아닙니다. (이 최초 다운로드도 화면 상단에 "최초 다운로드 중 X%" 진행바로 보여줘서, 뭐가 멈춘 건지 몰라 답답할 일은 없게 해놨습니다.)

토큰을 실제로 쓰는 지점은 딱 둘입니다.