레오의 빌드로그
글프로젝트소개English

야누스

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

화면

개요

기간
2026.08 – 현재 (개발 중)
팀
1인 개발
역할
기획 · 설계 · 데스크톱 앱 · 백엔드 · 로컬 추론

풀고 싶었던 문제

코딩 에이전트가 답변을 마쳐도 파일 변경 확인, 테스트, 리뷰, 커밋이 남음. 로컬 컴퓨터의 제한된 자원으로 검증된 작업 결과를 얼마나 얻을 수 있는지가 출발점.

해결 방법

  1. 01
    Task 하나에 작업 맥락을 모음대화·터미널·에디터·미리보기·리뷰를 Task에 모으고, 실행 중·입력 필요·실패·리뷰 대기 상태를 구분
  2. 02
    로컬 모델과 구독형 CLIMLX 로컬 모델(Qwen 27B 4-bit)이 기본이고, 이미 로그인한 Claude Code·Codex CLI도 실행기로 선택
  3. 03
    검증한 변경만 커밋Git diff를 기준으로 검증과 리뷰를 거쳐 커밋하고, 선택적으로 gh CLI로 push·PR까지 연결

아키텍처

아키텍처데스크톱백엔드에이전트리뷰대상로컬 HTTP · WSIPC프로세스 관리모델 서버 관리추론리뷰 흐름
React UITask · 에디터 · 터미널 · 미리보기
Electron Main프로세스 · IPC
FastAPITask API · HTTP·WebSocket
SQLite작업 · 세션 기록
MLX RuntimeQwen 27B 4-bit
Orchestratorworker 위임 · 자원 예산
Tools파일 · 셸 · 검증
Git diff변경 기준
검증 · 리뷰현재 revision
Commit · Push · PRgh CLI 선택 연동
선택한 저장소 · 현재 브랜치
  1. 01
    로컬 우선MLX 로컬 모델(Qwen 27B 4-bit)로 기기 내 추론
  2. 02
    자원 제한worker 수와 시간·토큰·단계 예산을 제한
  3. 03
    상태 구분실행 종료 ≠ 검증 완료 ≠ 리뷰 수락 ≠ 커밋 성공

사용자 시나리오

사용자 시나리오사용자시스템재시도 경로승인 요청아니오예 · 리뷰 수락 후
개발자
Task 생성프로젝트 · 목표
실행기 선택MLX 로컬 / Claude Code · Codex
도구 승인파일 · 셸 호출 확인
diff · 검증 확인같은 화면에서
리뷰 수락커밋 · push · PR
에이전트 실행Orchestrator · worker
도구 실행저장소 현재 브랜치
Git diff · 테스트현재 revision
커밋 · pushHEAD · SHA 확인
검증 통과?
실패 원인 확인 · 재실행실행 상태 ≠ 성공
  1. 01
    사용자 흐름Task → 실행기 → 도구 승인 → diff·검증 → 리뷰 수락
  2. 02
    시스템 흐름에이전트 실행 → 도구 실행 → Git diff·테스트 → 커밋
  3. 03
    상태 구분답변 완료 ≠ 작업 성공 — 검증 실패 시 재실행

담당 업무

  1. 01
    예산을 건 위임오케스트레이터가 하위 작업을 worker에 맡기되 worker 수와 시간·토큰·단계 예산을 제한하고, AgentProfile로 쓸 도구를 정함오케스트레이터 · worker · AgentProfile · 자원 스케줄러
  2. 02
    생성과 검증의 대기 분리로컬 모델의 생성 슬롯과 도구·검증 작업을 따로 관리해, 생성을 기다리는 동안 할 수 있는 검증을 겹쳐 실행MLX · 생성 슬롯 · 큐 우선순위 · 시간·토큰 상한
  3. 03
    상태를 나눠 기록실행 종료, 검증 완료, 리뷰 수락, 커밋·push 성공을 서로 다른 상태로 다루고, push 전 Janus가 기록한 커밋과 HEAD 일치를 확인Git diff · revision 단위 리뷰 · SHA 확인 · gh CLI
  4. 04
    실행 경로별 권한 경계로컬 모델과 Claude Code 경로는 Janus의 도구 승인 흐름을 쓰고, 경로마다 다른 통제 범위를 문서로 공개MCP · 기본 거부 승인 · HTTP/WS 토큰·Origin 검사
  5. 05
    문서와 코드 일치 검사설계 문서가 현재 기능을 보장하는 것처럼 읽히지 않도록 주요 설명을 코드와 대조하는 테스트를 CI에 둠pytest · TypeScript 검사 · 번들 크기 · 의존성 감사 · macOS 패키징 CI

기술 사용 이유

로컬 LLM · MLX코드·작업 맥락의 외부 반출 금지기기 내 추론으로 Agent 실행
Python워커의 쓰기 권한·자원 사용 무제한읽기 전용 강제, 워커별 단계·토큰·시간 예산
Git변경 출처 불분명, 답변 완료 ≠ 작업 성공diff·브랜치를 변경 기준으로, 검증 결과를 완료 기준으로
FastAPI · SQLite로컬 실행과 화면의 연결, Task 상태 보존로컬 API 연결, Task·세션 기록 저장
Electron · React · TypeScript대화·터미널·에디터·리뷰의 분산한 화면에서 변경·검증·리뷰·커밋 상태 표시

개선 기록

  1. 01
    worker 효율 개선같은 고정 worker 정책에서 수용 검증 통과 14/15를 유지하며 소요 시간 109.9초 → 88.1초, 프롬프트 토큰 14,855 → 10,993으로 감소 (2026-08-23 v1 감사)
  2. 02
    실제 27B 모델로 반복 검증TaskSuite 45회 중 44회 수용 검증 통과, 281회 복구 반복 후 일시 상태 잔여 0과 SQLite 무결성 확인
  3. 03
    중단된 작업을 성공으로 표시하지 않기앱이 다시 시작되면 이전 작업을 중단 상태로 복구하고, 작업 데이터 백업·복원과 민감정보를 뺀 진단 묶음 제공

관련 글