Free
Rider

API 개발에서는 요청을 보내는 일 자체보다 주변 작업이 더 자주 반복됩니다. 환경별 값을 바꾸고, 로그인 응답에서 토큰을 꺼내 다음 요청에 넣고, OpenAPI가 바뀌면 컬렉션과 차이를 확인하고, 검토한 결과를 Git에 남겨야 합니다. SSE나 WebSocket을 확인할 때는 다시 다른 도구를 켜게 됩니다.

이 흐름을 클라우드 워크스페이스가 아니라 로컬 파일과 로컬 실행을 기준으로 묶었습니다. 서버 계정이 없어도 바로 시작하고, 팀에 공유할 것은 컬렉션과 명세 같은 파일로 남기도록 경계를 정했습니다.

명세 검토를 사람과 Agent가 같은 규칙으로 수행

OpenAPI 변경 검토 흐름은 UI뿐 아니라 MCP 인터페이스에도 노출했습니다. Agent가 변경 목록을 읽고 검토하더라도 실제 반영 전에는 같은 충돌·선택 규칙을 거치도록 해, 자동화가 앱의 상태 모델을 우회하지 않게 했습니다.

Electron renderer가 직접 파일·Git·네트워크 권한을 모두 갖게 두지 않고 main process의 IPC 경계를 통해 필요한 기능만 노출했습니다. 워크스페이스는 로컬에 저장하고 민감 값은 공유 컬렉션 파일에서 분리합니다.

전후처리 스크립트는 앱 프로세스 안에서 그대로 eval하지 않고 Worker의 QuickJS 런타임에서 제한된 API만 제공합니다. OpenAPI 동기화도 새 명세를 곧바로 덮어쓰지 않고, 비교 결과를 중간 상태로 만들어 사용자의 결정 이후 저장합니다.

macOS Apple Silicon과 Intel 빌드를 GitHub Releases로 배포하고 Homebrew Cask 설치 경로를 제공했습니다. 릴리즈 워크플로가 새 버전의 Cask 버전과 SHA-256을 갱신하도록 연결해 코드가 완성된 뒤의 배포 작업도 자동화했습니다.

Electron smoke test는 임시 워크스페이스·임시 Git 저장소·테스트 HTTP 서버를 사용해 실제 사용자 데이터와 분리했습니다. 요청 실행과 저장, 명세 동기화, Git 흐름을 기능 단위가 아니라 실제 앱 경계에서 검증하는 쪽을 택했습니다.

Free Rider는 새로운 프로토콜을 발명한 프로젝트가 아닙니다. 대신 이미 개발자가 하던 요청·변수·명세·실시간 연결·Git 검토를 한 데이터 모델과 한 실행 흐름 안에 배치했습니다.

그 과정에서 데스크톱 앱의 권한 경계, 명세 변화의 안전한 반영, 로컬 파일과 자동화 Agent가 함께 쓰는 인터페이스, 설치·업데이트까지 포함한 배포 운영을 한 제품 안에서 다뤘습니다.