dirac-run/dirac

Dirac – 오픈소스 AI 코딩 에이전트

Dirac은 대규모 코드베이스에서 개발자가 코드를 작성, 리팩터링, 관리할 수 있도록 설계된 프로그래밍 가능한 AI 어시스턴트입니다. VS Code(Agent Client Protocol을 지원하는 모든 편집기), 명령줄 또는 JetBrains, Zed와 같은 ACP 호환 IDE에서 실행할 수 있습니다.

Dirac의 차별점은 무엇인가?

기능	중요성
제공업체 비종속	수십 개의 LLM 제공업체(OpenAI, Anthropic, Gemini, Groq, Mistral 등) 및 모든 사용자 정의 엔드포인트와 작동합니다. 이미 보유한 자격 증명을 유지할 수 있습니다.
목표 모드	단일 고수준 목표(/goal <objective>)를 제공하면 Dirac이 목표가 달성될 때까지 몇 시간 동안 작업을 계속하고 하위 작업을 생성 및 조정합니다. 언제든지 일시 중지, 조종 또는 중지할 수 있습니다.
해시 앵커 파일 편집	취약한 검색 및 바꾸기 대신 Dirac은 각 줄에 안정적인 해시를 태그합니다. 편집은 정확한 앵커를 대상으로 하므로 다른 인근 변경 사항의 영향을 받지 않으며 훨씬 적은 토큰을 소비합니다.
AST 기반 검사 및 조작	에이전트는 파일 개요를 요청하거나 특정 함수 구현을 가져오거나 원시 텍스트가 아닌 추상 구문 트리를 사용하여 전체 리포지토리에서 기호를 바꾸거나 이름을 바꿀 수 있습니다.
병렬 배치 작업	여러 독립적인 읽기, 검색, 편집 및 셸 명령을 단일 모델 응답으로 묶어 왕복 및 대기 시간을 줄일 수 있습니다.
하위 에이전트	별도의 에이전트(예: 하나는 연구, 다른 하나는 편집)가 각각 고유한 프롬프트, 도구 및 시간 제한으로 동시에 실행될 수 있으며, Dirac은 오래된 쓰기를 방지하기 위해 최신 상태를 추적합니다.
유틸리티 모델	더 저렴한 "유틸리티" 모델이 컨텍스트 압축, 커밋 메시지 생성 또는 권한 확인과 같은 저렴한 작업을 처리하여 기본 모델이 무거운 코딩에 집중할 수 있도록 합니다.
낮은 장황 모드	모델의 잡담을 끄고 결정, 검증 결과 및 최종 diff만 표시합니다.
권한 및 승인 워크플로	자동 승인은 자연어 정책으로 관리할 수 있습니다. 불확실한 사항은 사용자에게 에스컬레이션되고 기록에 기록됩니다.
연속성 및 체크포인트	장기 실행 작업은 체크포인트로 저장됩니다. 나중에 다시 시작하거나, 이전 작업 공간 상태를 복원하거나, 저장된 지점에서 작업을 재생할 수 있습니다.

일반적인 워크플로

1. 설치 – VS Code 확장, npm CLI(npm install -g dirac-cli) 또는 편집기의 ACP 레지스트리에서 Dirac 추가.
2. 제공업체 구성 – 모델을 선택하고 API 키를 제공합니다(OPENAI_API_KEY, ANTHROPIC_API_KEY 등의 환경 변수가 지원됨).
3. 세션 시작 – UI 또는 터미널에서 /goal "Add logging to all HTTP handlers"를 입력합니다.
4. 작동 확인 – Dirac이 작업을 계획하고, AST를 검사하고, 정확한 편집을 수행하고, 테스트를 실행하고, 다중 파일 diff를 보고합니다.
5. 조종 또는 승인 – 변경이 필요한 경우 메시지를 보냅니다. 권한 요청이 나타나면 정책에 따라 승인하거나 거부합니다.
6. 완료 – 에이전트가 수락 기준을 검증하고 체크포인트를 생성하며 변경 사항을 자동으로 커밋할 수 있습니다.

벤치마크

Dirac은 실제 리포지토리(VS Code, Transformers, Django)의 8가지 다중 파일 리팩터링 작업에서 여러 오픈소스 에이전트 하네스와 비교되었습니다. 동일한 gemini-3-flash-preview 모델을 사용하여 Dirac은:

• 8개 작업 모두 완료(100% 성공)했으며, 차점 하네스는 6-8개 작업에서 성공했습니다.
• 가장 낮은 평균 토큰 비용 달성 – 작업당 0.18달러, 경쟁업체는 0.38-0.73달러.

설치 빠른 시작

인터페이스	명령 / 링크
VS Code / Open VSX	Visual Studio Marketplace 또는 Open VSX에서 Dirac을 설치합니다.
CLI	npm install -g dirac-cli(Node 22-24 필요).
ACP 편집기	편집기의 ACP 레지스트리에서 설치하거나 dirac --acp를 실행합니다.

CLI 사용 예시

# 한 번 인증
dirac auth
# 간단한 분석
ndirac "Analyze the architecture of this project"
# 목표 모드 – 무인
ndirac --yolo "Fix the failing tests"
# git diff를 Dirac에 파이프하여 검토
git diff | dirac "Review this"

확장성

• 사용자 정의 도구 – /new-tool <description>으로 작은 유틸리티를 설명할 수 있습니다. Dirac이 생성, 컴파일, 검증하고 즉시 사용할 수 있게 합니다.
• 하위 에이전트 – 각각 고유한 도구 세트와 시간 제한을 가진 여러 에이전트를 병렬로 실행합니다.
• 리포지토리 인식 후크 – 모든 작업에 자동으로 영향을 미치는 경로 기반 규칙, 기술 및 워크플로를 정의합니다.

커뮤니티 및 개발

• Apache 2.0에 따라 오픈소스 – Cline 프로젝트의 포크.
• 기여를 환영합니다. 린팅, 테스트 및 빌드 단계는 CONTRIBUTING.md를 참조하세요(npm run install:all, npm run compile).
• Star 기록은 꾸준한 커뮤니티 관심을 보여줍니다.

---

요약: Dirac은 대규모 언어 모델이 실제 코드베이스를 안정적으로, 대규모로, 그리고 비용과 자율성을 세밀하게 제어하면서 편집하는 데 필요한 도구를 제공하는 완전한 기능을 갖춘 제공업체 비종속 AI 코딩 에이전트입니다.