어떤 모델이든,
내 터미널에서

파일을 읽고 고치고 명령을 실행하는 코딩 에이전트입니다. 백엔드는 OpenAI 호환 엔드포인트면 무엇이든 — 로컬 Ollama 도, 클라우드 게이트웨이도 같은 코드로 붙습니다.

npm install -g git+https://github.com/JangTaeGyu/koda-cli.git

Node 18+ · 설치 후 koda 한 번이면 실행됩니다

~/.koda/settings.json

koda — ~/projects/api-server

> auth 미들웨어에 rate limit 붙여줘

● 현재 구조를 먼저 확인합니다.
  ⎿ grep "middleware" src/          4 files
  ⎿ read_file src/auth.js            86 lines

● 의존성 추가 없이 in-memory 로 구현합니다.
  ⎿ edit_file src/auth.js            +24 −2
  ⎿ write_file src/rateLimit.js      created

⚠ bash npm test                    승인 필요
  [y] 실행   [n] 취소   [a] 항상 허용

기본 탑재

설치하면 바로 되는 것들

백엔드 주소와 모델 이름만 넣으면 나머지는 기본값으로 동작합니다.

도구 12종

읽기 · 정밀 편집 · glob/grep 탐색 · bash 실행 · 웹 fetch/search · 서브에이전트 위임 · 할 일 추적.

권한 파이프라인

실행 전에 셸 체이닝 · 경로 이탈 · 민감 파일을 막습니다. 모드는 plan 부터 auto-all 까지.

↺

되돌리기

파일을 고치기 직전 자동 스냅샷. /restore 로 언제든 이전 상태로 돌립니다.

⇉

병렬 실행

읽기 계열 도구가 여러 개면 동시에 돕니다. 결과 순서는 호출 순서 그대로.

◱

컨텍스트 관리

동적 출력 한도, 단계적 압축, 도구 결과 상한. 대화가 길어져도 알아서 줄입니다.

⟲

작은 모델 대응

도구 호출을 텍스트로 뱉거나 응답이 중간에 잘려도 복구합니다. 로컬 모델에서 체감이 큽니다.

확장

프로젝트에 맞게 붙입니다

.koda/ 에 파일을 두면 인식합니다. 고친 뒤에는 재시작 없이 /reload.

.koda/skills/<name>/SKILL.md

모델이 필요할 때 스스로 불러 쓰는 지식 패키지

.koda/agents/<name>.md

독립 컨텍스트로 위임하는 서브에이전트 페르소나

.koda/commands/<name>.md

자주 쓰는 프롬프트를 /명령 슬래시 단축어로

settings.json → mcpServers

MCP 서버 연결 (stdio · HTTP)

settings.json → hooks

도구 실행 전후 이벤트 훅 — 차단·허용 결정까지

KODA.md

프로젝트 규칙을 매 요청 시스템 프롬프트에 주입

임베드

대화창 밖에서도 씁니다

스크립트 · CI · 앱에 그대로 붙습니다.

`koda -p "질문"`

헤드리스 실행. text · json · stream-json 중에 골라 파이프로 넘깁니다.

`koda-cli/sdk`

query() · createSession(). 권한 · 도구 · 복구가 전부 딸려옵니다.

`koda serve`

로컬 HTTP+SSE 데몬. 앱이나 확장이 붙어도 권한 판정은 서버에 남습니다.

어떤 모델이든,내 터미널에서