야누스
로컬 LLM 기반 에이전트 코딩 IDE

화면
개요
- 기간
- 2026.08 – 현재 (개발 중)
- 팀
- 1인 개발
- 역할
- 기획 · 설계 · 데스크톱 앱 · 백엔드 · 로컬 추론
풀고 싶었던 문제
코딩 에이전트가 답변을 마쳐도 파일 변경 확인, 테스트, 리뷰, 커밋이 남음. 로컬 컴퓨터의 제한된 자원으로 검증된 작업 결과를 얼마나 얻을 수 있는지가 출발점.
해결 방법
- 01Task 하나에 작업 맥락을 모음대화·터미널·에디터·미리보기·리뷰를 Task에 모으고, 실행 중·입력 필요·실패·리뷰 대기 상태를 구분
- 02로컬 모델과 구독형 CLIMLX 로컬 모델(Qwen 27B 4-bit)이 기본이고, 이미 로그인한 Claude Code·Codex CLI도 실행기로 선택
- 03검증한 변경만 커밋Git diff를 기준으로 검증과 리뷰를 거쳐 커밋하고, 선택적으로 gh CLI로 push·PR까지 연결
아키텍처
- 01로컬 우선MLX 로컬 모델(Qwen 27B 4-bit)로 기기 내 추론
- 02자원 제한worker 수와 시간·토큰·단계 예산을 제한
- 03상태 구분실행 종료 ≠ 검증 완료 ≠ 리뷰 수락 ≠ 커밋 성공
사용자 시나리오
- 01사용자 흐름Task → 실행기 → 도구 승인 → diff·검증 → 리뷰 수락
- 02시스템 흐름에이전트 실행 → 도구 실행 → Git diff·테스트 → 커밋
- 03상태 구분답변 완료 ≠ 작업 성공 — 검증 실패 시 재실행
담당 업무
- 01예산을 건 위임오케스트레이터가 하위 작업을 worker에 맡기되 worker 수와 시간·토큰·단계 예산을 제한하고, AgentProfile로 쓸 도구를 정함오케스트레이터 · worker · AgentProfile · 자원 스케줄러
- 02생성과 검증의 대기 분리로컬 모델의 생성 슬롯과 도구·검증 작업을 따로 관리해, 생성을 기다리는 동안 할 수 있는 검증을 겹쳐 실행MLX · 생성 슬롯 · 큐 우선순위 · 시간·토큰 상한
- 03상태를 나눠 기록실행 종료, 검증 완료, 리뷰 수락, 커밋·push 성공을 서로 다른 상태로 다루고, push 전 Janus가 기록한 커밋과 HEAD 일치를 확인Git diff · revision 단위 리뷰 · SHA 확인 · gh CLI
- 04실행 경로별 권한 경계로컬 모델과 Claude Code 경로는 Janus의 도구 승인 흐름을 쓰고, 경로마다 다른 통제 범위를 문서로 공개MCP · 기본 거부 승인 · HTTP/WS 토큰·Origin 검사
- 05문서와 코드 일치 검사설계 문서가 현재 기능을 보장하는 것처럼 읽히지 않도록 주요 설명을 코드와 대조하는 테스트를 CI에 둠pytest · TypeScript 검사 · 번들 크기 · 의존성 감사 · macOS 패키징 CI
기술 사용 이유
기술문제역할
로컬 LLM · MLX코드·작업 맥락의 외부 반출 금지기기 내 추론으로 Agent 실행
Python워커의 쓰기 권한·자원 사용 무제한읽기 전용 강제, 워커별 단계·토큰·시간 예산
Git변경 출처 불분명, 답변 완료 ≠ 작업 성공diff·브랜치를 변경 기준으로, 검증 결과를 완료 기준으로
FastAPI · SQLite로컬 실행과 화면의 연결, Task 상태 보존로컬 API 연결, Task·세션 기록 저장
Electron · React · TypeScript대화·터미널·에디터·리뷰의 분산한 화면에서 변경·검증·리뷰·커밋 상태 표시
개선 기록
- 01worker 효율 개선같은 고정 worker 정책에서 수용 검증 통과 14/15를 유지하며 소요 시간 109.9초 → 88.1초, 프롬프트 토큰 14,855 → 10,993으로 감소 (2026-08-23 v1 감사)
- 02실제 27B 모델로 반복 검증TaskSuite 45회 중 44회 수용 검증 통과, 281회 복구 반복 후 일시 상태 잔여 0과 SQLite 무결성 확인
- 03중단된 작업을 성공으로 표시하지 않기앱이 다시 시작되면 이전 작업을 중단 상태로 복구하고, 작업 데이터 백업·복원과 민감정보를 뺀 진단 묶음 제공