I built a free autonomous coding agent for your terminal — bring your own API key

개요

Codeably는 터미널에서 작동하는 무료 자율 코딩 에이전트로, 사용자가 API 키를 제공하여 LLM 모델을 직접 호출하는 방식을 비용 없이 활용할 수 있도록 합니다.

주요 내용

* 기능: 사용자가 영어로 작업을 설명하면 Codeably가 이를 이해하고 bash 코드 실행, 유닛 테스트 작성, 코드 클리닝, 버그 수정 등 작업을 수행합니다. codeably clean, codeably review, codeably chat과 같은 명령어를 지원합니다.
* 작동 방식: Observe → Think → Act → Verify → Done의 루프를 반복하며 작업을 완료합니다.
* API 키 통합: Groq, Gemini, LlamaCode(로컬), OpenRouter, Anthropic, Mistral, OpenAI 등 7개 이상의 LLM 제공업체를 지원하며, 사용자 고유의 API 키를 사용하므로 별도의 비용이 발생하지 않습니다. Groq의 Llama 3.3 70B 모델은 빠른 속도와 무료 티어로 인해 개발자가 개인적으로 사용하는 주요 모델입니다.
* 편의 기능: cb라는 짧은 명령어로 대체 가능하며, macOS/Linux/WSL 및 Windows PowerShell 환경에서 바로 사용할 수 있는 설치 스크립트를 제공합니다. codeably chat 명령어를 통해 터미널 내에서 채팅 UI를 열어 대화형으로 코딩 작업을 수행할 수 있으며, 마크다운 렌더링, 대화 기록, 실시간 공급자 전환 등의 기능을 지원합니다.
* 내장 도구: 파일 I/O, 쉘 명령어, Git 작업, 코드 검색, 불필요한 코드 탐지 등 30가지 이상의 도구를 제공하며, patch_file, grep_replace, git_commit, confirm_delete, detect_language, run_script와 같은 도구들이 포함됩니다.
* 안전 기능: 파일 삭제 시 confirm_delete 도구를 통해 사용자의 명시적인 승인을 받도록 하여 안전성을 강화했습니다.
* 구축 방식: LangChain이나 다른 프레임워크 없이 약 900줄의 순수 Node.js 코드로 작성되었으며, 7개 제공업체 모두와 호환되는 OpenAI 호환 클라이언트, 간단한 루프, 30가지 도구 정의로 구성됩니다.
* 개발 동기: 기존 AI 코딩 도구들이 유료 구독료 대비 LLM 모델 직접 호출과 큰 차이가 없는 래퍼(wrapper)에 그치는 문제점을 해결하기 위해 직접 개발했으며, 약 일주일 소요되었습니다.

시사점

Codeably는 사용자가 자체 API 키를 활용하여 AI 코딩 도구에 대한 구독 비용을 절감하면서도 효율적인 개발 워크플로우를 구축할 수 있는 실용적인 솔루션을 제공합니다.