app-saas / 2026.06

MacAgent — macOS 작업 자동화 에이전트

macOS 접근성, 도구 실행, vault 메모리를 묶어 로컬 작업을 보조하는 TypeScript 기반 에이전트 패키지입니다.

패키지 구조 설계·자동화 도구 구현·테스트

Metrics

mac-agent/vault-agent/core 패키지 분리
권한·메모리·도구 테스트 포함
macOS 접근성 자동화 경계 명시

Stack

TypeScriptNode.jsmacOS AXSQLiteTypeScript

Problem

로컬 데스크톱 작업은 브라우저 자동화만으로 해결되지 않습니다. 창, 파일, 앱, 접근성 권한, 명령 실행이 함께 필요합니다.

Idea

MacBook에서 반복되는 로컬 작업을 AI가 안전하게 돕게 하려면, 먼저 MacKit 패키지 구조가 필요했습니다.

Decision

core, mac-agent, vault-agent, discord 등 패키지를 분리하고, 권한·실행기·메모리·도구 인터페이스를 테스트 가능한 단위로 나눴습니다.

Outcome

로컬 자동화가 단일 스크립트가 아니라, 권한과 도구 경계를 가진 패키지로 정리됐습니다.

문제

로컬 자동화는 웹 자동화와 다릅니다. 앱 창 상태, 접근성 권한, 파일 시스템, 셸 실행이 섞입니다. 잘못 실행하면 사용자의 실제 작업 환경을 건드립니다.

결정

MacAgent는 패키지 경계를 먼저 분리했습니다. 실행기는 권한과 정책을 거치고, vault-agent는 기억을 다루며, core는 루프와 라우팅을 담당합니다. 테스트 가능한 단위로 쪼개는 것이 안전성의 시작점이었습니다.

성과

macOS 자동화 실험을 제품형 패키지로 정리할 수 있었습니다. AI가 데스크톱을 직접 조작할 때 필요한 권한 경계와 검증 가능성을 명확히 다룬 사례입니다.