Agent-Field/CodeAF

CodeAF – LLM 코딩을 위한 오픈소스 "소프트웨어 팩토리"

개요 – CodeAF는 머신에 있는 모든 저장소에서 LLM 기반 코딩 에이전트를 실행할 수 있는 Go 기반 명령줄 도구입니다. 모든 프로젝트, 활성 대화, 보류 중인 작업 및 비용을 나열하는 단일 "홈" 창을 제공합니다. 거기서 프로젝트를 탭으로 열고 자연어 요청을 전달하면 시스템이 자동으로 다음을 수행합니다:

계획: 작업을 독립적인 태스크로 분할하고 각각에 대해 브랜치를 생성합니다.
실행: 세 가지 모델 역할(플래너, 워커, 체커)로 구성된 팀이 작업을 실행합니다. 모델은 오픈 웨이트 모델 풀(DeepSeek, Qwen, GLM, Kimi, MiniMax, Ollama 등)에서 선택됩니다.
검사: 구성 가능한 테스트에 대해 결과를 검증하고 통과된 변경 사항만 병합합니다.
프롬프트: 결정이 필요한 경우에만 사용자에게 확인을 요청합니다(예: "어떤 비용 원장을 사용해야 할까요?").

그 결과, 많은 버그, 기능 추가 또는 리팩토링을 동시에 처리할 수 있는 "팩토리"가 구현되며, 사용자는 판단이 필요한 경우에만 개입하면 됩니다.

주요 개념

개념	기능
홈 / 탭	하나의 터미널 창에서 모든 저장소, 작업 및 비용을 표시. 새 터미널을 열지 않고 프로젝트 간 이동 가능.
대화 → 작업	자연어 요청을 작성하면 CodeAF가 이를 개별 작업으로 파싱하고 각각 고유 브랜치에서 실행.
서브 하니스	반복적인 작업(예: PR 리뷰, 의존성 분류)을 위한 전문 에이전트. 자체 모델 계획, 검사 및 타입 지정 I/O를 가짐.
팀 / 시트	각 작업에 대해 세 가지 모델 역할이 자동 선택됨: 플래너(계획 설계), 워커(코드 작성), 체커(테스트 실행). 특정 시트에 모델 고정 가능.
모델 풀	설치 환경에서 각 모델의 지연 시간, 비용, 성공률을 측정하고 해당 데이터를 사용하여 특정 시트에 가장 저렴하고 빠른 모델을 선택.
헤드리스 모드	`codeaf do …`를 통해 스크립트나 CI에서 단발성 요청을 실행하고 JSON 및 종료 코드를 반환.
원격 / 어디서나	UI는 로컬에서 실행되고 대화는 코드를 소유한 머신에 유지됨. SSH를 통해 노트북, 데스크톱, 휴대폰에서 연결 가능.
텔레메트리	익명 사용 통계(버전, OS, 토큰 대역, 오류)가 기본적으로 전송됨. 설정이나 환경 변수로 비활성화 가능.

설치 및 사용 방법

curl -fsSL https://agentfield.ai/get/codeaf | bash   # 단일 바이너리 설치 (~53 MB)
codeaf                                            # UI 시작

VERSION=<tag>로 버전을 고정하거나 소스에서 빌드(make build)하세요.

일반적인 워크플로우:

codeaf home – 모든 프로젝트 보기.
enter <project> – 저장소 탭 열기.
요청 입력(예: fix the flaky test that fails 1/5 runs).
UI가 작업 트리를 생성. 개별 하위 작업을 승인/거부.
승인된 변경 사항이 새 브랜치에 반영. 준비되면 병합.

벤치마크 및 성능

DeepSWE 벤치마크 – 내장된 /senior-dev 서브 하니스는 113개의 실제 GitHub 이슈 중 최고 비율(54.9%)을 DeepSeek V4 Flash에서 해결했으며, 해결당 비용도 가장 낮아 Claude Code, Codex, Kilo 등을 능가했습니다.
리소스 점유 – 단일 바이너리 53 MB, 세션당 약 27 MB RAM, 16개의 유휴 세션이 약 0.5 GB 사용. 이는 경쟁 에이전트보다 4~21배 가볍습니다.

벤치마크 세부 정보는 docs/benchmarks/를 참조하세요.

CodeAF 활용 사례

멀티 저장소 개발 – 여러 서비스에 걸쳐 버그, 기능, CI를 관리해야 하는 팀.
비용 효율적인 LLM 사용 – 품질 요구 사항을 충족하는 가장 저렴한 모델을 자동 선택.
자동화 – CI 파이프라인에서 헤드리스 codeaf do …를 호출하여 일괄 수정(예: 의존성 업그레이드) 적용.
확장성 – 도메인별 작업을 위해 자체 서브 하니스 작성 가능.

제한 사항(초기 프리뷰 버전)

개발 중이므로 버그나 충돌이 발생할 수 있습니다.
대부분의 모델은 OpenRouter 또는 제공업체 API 키가 필요합니다(Ollama는 로컬에서 작동).
텔레메트리는 기본적으로 활성화되어 있습니다(비활성화 가능).
UI는 터미널 기반이며 그래픽 IDE 통합은 아직 없습니다.

결론 – CodeAF는 LLM을 조정된 멀티 프로젝트 코딩 어시스턴트로 바꿔주는 진정한 오픈소스 프로젝트로, 비용 효율성, 작업 자동화 및 단일 창 워크플로우를 강조합니다. 여러 터미널을 전환하거나 수동으로 프롬프트 엔지니어링을 할 필요 없이 오픈 웨이트 모델을 활용하려는 개발자에게 적합합니다.