little-coder

AI Coding ToolsCLITypeScript

★ 2,581주당 +22조회 5

무엇인가

little-coder는 터미널에서 동작하는 코딩 에이전트 CLI다. 에이전트 루프, TUI, 세션 트리, 컴팩션 같은 기반 기능은 pi에서 그대로 가져오고 그 위에 소형 모델용 확장과 스킬을 얹은 배포판에 해당한다. 포크가 아니라 pi를 package.json의 일반 의존성으로 두고 설정과 확장만 덧붙이는 구조다.

어떻게 동작하나

런처(bin/little-coder.mjs)는 pi를 --no-extensions로 실행하고 번들에 포함된 확장 집합만 주입한다. 확장은 .pi/extensions/, 스킬은 skills/ 아래 마크다운 파일, 벤치마크는 benchmarks/의 Python 하네스로 나뉜다. 모델 기본값은 models.json의 default 키가 정하고 사용자 오버라이드 파일로 바꾼다. 세션은 pi의 세션 트리와 컴팩션을 그대로 쓰며, 계획 모드에서 승인한 계획은 .pi/approved-plan.md에 저장된다.

무엇과 다른가

일반적인 pi 사용과의 차이는 로딩 범위를 고정한다는 점이다. 전역으로 pi install한 패키지는 pi 설정에 등록되지만 --no-extensions가 이를 건너뛰므로 기본값으로는 로드되지 않는다. 대신 ~/.config/little-coder/extensions/에 두거나 LITTLE_CODER_EXTRA_EXTENSIONS로 경로를 지정하거나 --with-pi-extensions로 재실행하는 세 가지 선택지가 있다. 설치 스크립트 없이 런처가 실행 시점에 모든 것을 구성하는 것도 이 방식의 결과다.

어떻게 쓰나

설치 후 little-coder를 실행하면 models.json의 기본 모델로 세션이 열린다. --model로 클라우드 모델을 지정할 수도 있고 작업 디렉터리는 실행한 디렉터리다. ctrl+q로 계획 모드를 켜고 /implement로 계획을 실행 세션에 넘긴다. f2는 읽기 전용 리서치 서브코더를 임시 스크래치 디렉터리에서 돌려 인용 포함 마크다운 보고서를 만든다. /extensions, /skills, /hotkeys로 로드된 확장과 스킬 카드, 단축키를 확인한다.

전제와 한계

Node.js 22.19 이상이 PATH에 있어야 하며 bun으로 설치해도 런타임은 Node다. 기본 모델 지정은 첫 실행에만 적용되고 세션에서 모델을 고르면 그 선택이 유지된다. 서브코더는 기본 직렬 실행이고 LITTLE_CODER_SUBCODER_CONCURRENCY로 병렬 수를 늘린다. f2 딥 리서치는 외부·온라인 조사용이라 현재 작업 중인 코드 탐색에는 쓰지 않는다.

관련 논문 3

유사 도구