I built a USB drive that runs an offline AI coding agent on any laptop

개요

code-stick은 인터넷 연결이나 호스트 머신에 별도의 설치 없이, USB 드라이브를 완전 오프라인 AI 코딩 에이전트로 변환하는 CLI 도구입니다.

주요 내용

• code-stick의 기능: 파일 편집, 다단계 작업 수행, 도구 사용 등 AI 코딩 에이전트의 기능을 USB 드라이브 내에서 로컬 모델을 사용하여 지원합니다.
• 작동 방식: npx code-stick install 명령어를 실행하면 opencode, Ollama 사전 빌드 바이너리, 모델 가중치 등이 USB 드라이브에 다운로드됩니다. 이후 해당 USB를 Windows, macOS, Linux 노트북에 연결하고 매칭되는 런처를 실행하면 127.0.0.1에서 코딩 에이전트가 실행됩니다. 연결 해제 시 모든 프로세스가 종료되어 호스트 머신에 아무런 흔적이 남지 않습니다.
• 지원 모델: Qwen2.5-Coder, DeepSeek-Coder, CodeGemma, Phi-3 등 다양한 모델을 선택할 수 있습니다.
• 개발 동기: 인터넷 및 외부 API 접근이 불가능한 에어갭 환경, 공유 또는 임시 사용 머신, 개인정보 보호가 중요한 코드를 다룰 때와 같이 클라우드 기반 AI 코딩 에이전트가 적합하지 않은 상황을 해결하기 위해 개발되었습니다.
• 현재 상태 (v0.1.0): 모든 타겟 OS에서 엔드투엔드 테스트를 거쳤으며, CI 환경에서 Docker 기반의 스모크 테스트와 Vitest 유닛 테스트를 포함합니다. 크래시 리포트는 로컬로만 저장되며, MIT 라이선스로 제공됩니다.

시사점

code-stick은 인터넷 연결이 제한적이거나 데이터 보안이 중요한 환경에서 AI 코딩 지원을 가능하게 하는 휴대용 솔루션을 제공하며, 다양한 운영체제에서 별도의 설치 없이 즉시 사용 가능한 편리성을 제공합니다.