매일 아침, 어제의 AI를 한 통으로 정리해 보내드립니다메일로 받아보기

METAL LAB

apache/maka

★ 2,016오늘 +148TypeScript

AI 에이전트가 하는 모든 행동을 로그로 남기는, 내 컴퓨터에서 돌아가는 작업 공간

Apache Maka(인큐베이팅 단계)는 클라우드가 아니라 사용자 컴퓨터에 기본적으로 데이터를 저장하는 로컬 우선 AI 에이전트 작업 공간이다. 모델이 주고받은 메시지, 도구 호출, 도구 실행 결과, 권한 승인 여부, 종료 시점까지 모두 한 번 쓰면 지우지 않는 로그에 남기고, 화면에 보이는 세션이나 대화 기록은 이 로그를 다시 계산해 보여주는 것이다. 데스크톱 앱(macOS Apple Silicon), 터미널 인터페이스, 비대화형 CLI, 벤치마크 실험용 평가 도구까지 하나의 실행 축을 공유한다.

무엇을 하는 레포인가

  1. 무엇을 했나: 단순히 질문에 답하는 게 아니라, 권한 통제 하에 프로젝트 파일을 읽고 Read/Write/Edit/Bash/Glob/Grep 같은 도구를 실행하고 결과물을 만들어내는 에이전트 워크스페이스를 만들었다.
  2. 어떻게 했나: Runtime Host라는 하나의 실행 주체가 세션·턴·도구 실행·이벤트를 전담해 로컬 SQLite에 이벤트 로그로 기록하고, 데스크톱 화면·UI·복구 기능은 모두 이 로그를 다시 읽어 만든 결과물이다. 오래된 도구 실행 결과는 삭제 대신 정리(pruning)되거나 압축(compaction)된다.
  3. 실행 환경: Electron+React 기반 데스크톱 앱(현재는 서명된 macOS Apple Silicon 빌드만 제공), 터미널 TUI/CLI, 그리고 과제×반복×실험 대상 조합으로 벤치마크를 재현 가능하게 돌리는 Eval 모드로 구성된다.
  4. 데이터 처리: 세션과 설정, 자격증명은 기본적으로 로컬 기기에만 저장되며 자격증명 금고 파일은 운영체제 파일 권한으로 보호된다. 다만 이전 버전의 자격증명이나 대화 기록 파일 형식은 이번 빌드에서 가져오지 않으므로, 업그레이드 시 옛 대화가 빈 채로 열리거나 재로그인이 필요할 수 있다.
  5. 현재 상태: 활발히 개발 중인 초기 공개 버전으로 데이터 형식·CLI 명령·실험 기능이 앞으로 바뀔 수 있다. Computer Use 기능, 인텔 맥, 윈도우, 리눅스는 아직 정식 지원하지 않으며 윈도우는 서명되지 않은 프리뷰 상태다.

왜 중요한가

AI 코딩·작업 에이전트를 만들거나 검증하려는 사람에게, 클라우드 서비스가 아니라 모든 실행을 남기는 로그 자체를 신뢰와 복구의 기반으로 삼는 로컬 우선 설계 사례를 구체적으로 보여준다. 또한 로그가 곧 런타임이라는 개념, 권한 기반 도구 호출, 재현 가능한 평가 도구 같은 패턴은 다른 에이전트 프로젝트에도 참고가 될 수 있다.

이 레포의 용어

  • 로컬 우선(local-first) · 데이터와 실행을 클라우드 서버가 아니라 사용자 기기에 기본적으로 두는 설계 방식
  • append-only 로그 · 한번 기록하면 수정하지 않고 계속 뒤에 덧붙이기만 하는 기록 방식
  • Runtime Host · 세션, 턴, 도구 실행, 이벤트 전체를 관리하는 단일 실행 주체
  • TUI · 마우스 없이 터미널 안에서 조작하는 텍스트 기반 인터페이스
  • 아티팩트(artifact) · 에이전트 작업으로 생성된 파일이나 결과물

레포 원문 소개 (영문)

Apache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.

GitHub에서 보기

관련 기사

주목받는 레포

레포 전체 보기 →

METAL LAB 최신 기사