원문: apache/maka (구 maka-agent/maka-agent) · 수집일: 2026-10-04 · 커밋 aef30ea · Stars 약 5.7천 · Apache-2.0 · TypeScript · 사이트 maka.apache.org

개요

Maka는 데스크톱(Electron)·TUI·CLI로 쓰는 범용 에이전트 워크스페이스다. 2026-05에 maka-agent/maka-agent로 시작해 지금은 Apache 인큐베이터 프로젝트(apache/maka)가 되었다. 아직 공식 Apache 릴리스는 없다.

프로젝트가 스스로 내세우는 기준은 하나다. 에이전트 harness는 “같은 모델로 몇 개의 작업을 얼마의 비용에 끝내느냐”로 평가한다. 그래서 다른 하네스와 같은 모델·같은 공식 검증기로 비교한 결과를 작업별 기록과 함께 docs/eval/에 공개한다.

핵심 설계

원칙내용
로그가 곧 런타임모델 메시지, 툴 호출, 권한 결정, 종료를 모두 append-only RuntimeEvent로 남긴다. UI·다음 프롬프트·크래시 복구는 이 로그의 *투영(projection)*일 뿐이다. 오래된 툴 출력은 다음 프롬프트에서는 빠져도 로그에서는 사라지지 않는다.
로컬 우선세션·설정·실행 기록은 로컬 runtime.sqlite에 둔다. 모델은 클라우드 API, 로컬 모델, 호환 게이트웨이 중 직접 연결한다(번들 계정 없음).
단일 Runtime Host데스크톱·TUI·CLI·Eval은 모두 하나의 실행 권한자(Runtime Host)의 얇은 클라이언트다.
측정 공개Eval 패키지가 실험 → 셀 → 시도 → 결과 구조로 벤치마크를 돌린다.

백엔드 흐름은 클라이언트 → Runtime Host → SessionManager → AgentRun → (Model + Tool Runtime) → Runtime Event Log → 컨텍스트·세션·UI 투영이다. 패키지는 core(계약), storage(SQLite), mcp, runtime, runtime-host, eval, computer-use(컴퓨터 사용 백엔드), cli, ui로 나뉘고 Rust 네이티브 애드온(P2P 피어·gitoxide)이 붙는다.

써볼 만한 기능

  • Graph 모드: maka run --graph "독립 슬라이스 두 개 구현 후 통합·리뷰"처럼 작업을 그래프로 쪼개 실행한다. 구현 단계는 격리된 git worktree를 쓰므로 원본이 깨끗한 worktree여야 한다.
  • 중단 턴 재개: 데스크톱과 /resume으로 끊긴 턴을 이어 간다(재개는 모델을 다시 호출하므로 토큰이 든다). MAKA_RUNTIME_SAFE_BOUNDARY_RESUME로 자동 재개 수준을 조절한다.
  • 샌드박스 경계: 파일 쓰기·셸 실행 툴은 샌드박스 경계를 통과해야 한다.

주의할 점

  • API 키는 credential-vault.json에 평문으로 저장된다(OS 계정 권한으로만 보호, 렌더러에는 노출 안 함).
  • 데이터 포맷·CLI 명령이 아직 바뀔 수 있다고 README가 명시한다. 이전 JSONL 대화 기록과 safeStorage 자격 증명은 가져오지 않는다.
  • docs/eval/의 벤치마크 수치는 직접 확인하지 않았다. 이 노트는 README의 주장과 저장소 구조만 근거로 한다.

위키 맥락