저는 AI 코딩 도구에 매달 20달러를 지불하는 것에 지쳤습니다. 그래서 직접 만들었습니다.
Codeably는 여러분의 터미널에서 실행되는 자율 코딩 에이전트 (autonomous coding agent)입니다. 여러분의 API 키를 직접 가져와 사용하므로, 실행 비용은 0달러입니다.

기능
여러분이 평이한 영어로 작업을 설명하면, 에이전트가 무엇을 해야 할지 파악하고 실행합니다:

codeably "express 앱에 JWT 인증 추가하기"
codeably "src/utils.js의 모든 함수에 대한 단위 테스트 (unit tests) 작성하기"
codeably "모든 데드 코드 (dead code)를 찾아서 제거하기"
codeably "payment.js의 레이스 컨디션 (race condition) 수정하기"
codeably clean # 스캔 + 데드 코드 자동 제거
codeably review # git 변경 사항에 대한 AI 코드 리뷰
codeably chat # 전체 터미널 채팅 UI 열기

이 도구는 작업이 완료될 때까지 관찰(Observe) → 생각(Think) → 행동(Act) → 검증(Verify) → 완료(Done)의 루프를 실행합니다.

지금 바로 사용해 보세요 (설치 불필요)

npx codeably "여기에 작업 입력"

또는 전역(globally)으로 설치하세요:

npm install -g codeably

7개의 제공업체 — 대부분 무료 티어 (free tiers) 제공
여러분의 키를 연결하기만 하면 됩니다. 사용 가능한 목록은 다음과 같습니다:

제공업체 (Provider)	모델 (Model)	무료 티어 (Free tier)
Groq	Llama 3.3 70B	✅ 하루 14,400회 요청 무료
Gemini	Gemini 2.0 Flash	✅ 하루 1,500회 요청 무료
Ollama	CodeLlama (로컬)	✅ 무제한 무료 오프라인
OpenRouter	100개 이상의 모델	✅ 무료 모델 사용 가능
Anthropic	Claude Sonnet 4	가입 시 5달러 크레딧
Mistral	Mistral Large	무료 체험 크레딧
OpenAI	GPT-4o	사용량만큼 지불 (pay per use)

저는 개인적으로 일상 업무에 Groq를 사용합니다. 빠르고 무료이며, Llama 3.3 70B 모델은 코딩 실력이 정말 뛰어납니다.

⚡ codeably 대신 cb 입력하기
한 번의 명령으로 설정하는 단축키:

macOS / Linux / WSL:

bash install-shortcut.sh
source ~/.zshrc
cb "작업 내용"

Windows PowerShell:

.\install-shortcut.ps1
. $PROFILE
cb "작업 내용"

터미널 채팅 UI

codeably chat

# 또는

cb chat

터미널에서 바로 전체 채팅 UI를 엽니다:

╭────────────────────────────────────────────────────────────╮
│ >/< codeably chat │
│ groq · llama-3.3-70b-versatile │
│ type /help for commands │
╰────────────────────────────────────────────────────────────╯

❯ explain how async/await works

Async/await는 Promise (프로미스)를 기반으로 구축된 문법적 설탕 (syntactic sugar)입니다...

❯ /switch ← 대화 도중 제공자 (provider) 전환
❯ /history ← 대화 기록 보기
❯ /save ← 채팅을 파일로 저장
❯ /clear ← 새로 시작
❯ _
마크다운 렌더링 (markdown rendering), 대화 기록, 그리고 /switch를 통한 실시간 제공자 전환을 지원합니다.
30개의 도구
파일 I/O, 셸 명령 (shell commands), git 작업, 코드 검색, 데드 코드 탐지 (dead code detection) — 총 30개의 도구. 주요 기능은 다음과 같습니다:

patch_file — 안전한 문자열 치환 (전체 재작성 없음)
grep_replace — 여러 파일에 걸친 찾기 및 바꾸기
git_commit — 모든 변경 사항을 스테이징하고 메시지와 함께 커밋
confirm_delete — 무엇인가를 삭제하기 전에 항상 확인 요청
detect_language — 프로젝트의 스택을 자동 감지
run_script — 여러 줄의 bash 스크립트 작성 및 실행

안전 우선
Codeably는 사용자의 명시적인 승인 없이 파일을 삭제할 수 없습니다. 모든 삭제는 confirm_delete를 거칩니다:
⚠ 삭제 확인 필요
이유: 사용되지 않는 파일, 임포트(import) 감지되지 않음

삭제할 파일:

• src/old-utils.js
• src/deprecated/auth.js

이 2개의 파일을 삭제하시겠습니까? [y/N]:

구축 방식
프레임워크 없음. LangChain 없음. 마법 같은 요소 없음.
약 900줄의 순수 Node.js (vanilla Node.js). 7개의 모든 제공자와 호환되는 하나의 OpenAI 호환 클라이언트. 단순한 루프. 30개의 도구 정의.
codeably/
├── codeably.js ← CLI 진입점 + 모든 명령
├── runtime/
│ ├── agent.js ← 관찰-생각-행동 (Observe-Think-Act) 루프
│ ├── client.js ← 통합 LLM 클라이언트
│ └── context.js ← 코드베이스 스냅샷
├── tools/
│ └── index.js ← 30개 도구 전체
└── ui/
├── renderer.js ← 터미널 UI
└── chat.js ← 터미널 채팅 UI

실제 예시
bash# 기능 추가
codeably "add rate limiting — 100 req/min per IP"
codeably "add input validation to all API endpoints"
codeably "add TypeScript types to all files in src/"

정리

codeably clean
codeably "remove all console.log from src/"
codeably "migrate from callbacks to async/await in api.js"

테스트

codeably "auth routes에 대한 통합 테스트 (integration tests) 작성해줘"
codeably "React 컴포넌트에 에러 경계 (error boundary) 테스트를 추가해줘"

리팩터링 (Refactor)

codeably "400줄짜리 UserController를 더 작은 파일들로 분할해줘"
codeably "모든 하드코딩된 문자열을 상수 (constants) 파일로 추출해줘"

리뷰 + 문서화 (Review + docs)

codeably review
codeably docs

이것을 만든 이유
내가 시도해 본 모든 AI 코딩 도구들은 동일한 문제를 가지고 있었습니다. 모델에 직접 접근할 수 있음에도 불구하고, 그 모델을 사용하기 위해 구독료를 지불하고 있다는 점입니다. 도구는 그저 래퍼 (wrapper)일 뿐입니다.

그래서 제가 직접 그 래퍼를 작성했습니다. 약 일주일 정도 걸렸습니다. 이제 저는 이것을 매일 사용하며, Groq의 무료 티어 (free tier)만으로도 충분하기 때문에 비용이 전혀 들지 않습니다.

목표는 언제나 명확했습니다: 당신의 키를 직접 가져오고 (bring your own key), 당신의 에이전트를 소유하는 것.

GitHub: https://github.com/adamyasingh-05/Codeably
설치: npm install -g codeably
피드백을 환영합니다 — 어떤 기능이 추가된다면 여러분의 워크플로우 (workflow)에 더 유용할까요?