시작하기

Evo Mac이란

Evo Mac은 macOS에서 쓰는 Evo AI 에이전트 앱입니다. 작업할 폴더를 고르고 대화하면, 에이전트가 그 폴더의 파일을 읽고 고치고 명령을 실행합니다. 터미널 대신 앱 화면에서 Evo 에이전트를 쓰고 싶은 사용자를 위한 앱이며, Evo CLI와 같은 Evo 계정으로 로그인합니다. Windows에서는 Evo Windows를 씁니다. 이 문서는 0.2.8 버전을 기준으로 합니다.

준비

• macOS 13 이상
• Apple Silicon Mac, Intel Mac 모두 지원(universal 앱)
• Evo 조직 계정 또는 개인 계정

설치

설치 파일은 https://nexus.bluewindsky.com/repository/evo-bin/evo-mac/release/ 아래에 있습니다(공개, 로그인 필요 없음).

1. evo-mac_universal.dmg를 내려받습니다. 이 주소는 버전이 바뀌어도 같습니다(release/latest/). 지금 버전은 같은 폴더의 VERSION 파일에 있습니다. 특정 버전은 release/<버전>/evo-mac_<버전>_universal.dmg에 버전 번호가 붙은 이름으로 있습니다(예: 0.2.8은 release/0.2.8/evo-mac_0.2.8_universal.dmg). 두 폴더 모두 sha256sums.txt로 내려받은 파일을 확인합니다.
2. dmg를 열고 evo를 Applications 폴더로 끌어다 놓습니다. 앱은 Dock과 메뉴에 “evo”로 보입니다.

처음 열기

Apple Developer ID 서명과 공증 없이 임시(Ad-hoc) 서명으로 배포되는 앱이라 처음 열 때 경고가 뜹니다. Finder의 응용 프로그램 폴더에서 evo를 우클릭하고 “열기”를 누릅니다. 그래도 열리지 않으면 macOS의 시스템 설정 → 개인정보 보호 및 보안에서 열기를 허용합니다.

“그래도 열기”로 열리지 않으면

Intel Mac(macOS 15)에서 “그래도 열기”를 눌러도 Dock 아이콘만 뛰고 창이 뜨지 않을 수 있습니다. 서명·공증이 없는 앱에 브라우저로 받으면 붙는 격리 표시(com.apple.quarantine) 때문에 macOS가 첫 실행 확인 중 앱을 멈춰 둔 것으로, 앱 자체의 결함은 아닙니다.

터미널에서 아래 명령을 한 번 실행하면 바로 열립니다.

xattr -dr com.apple.quarantine /Applications/evo.app

이미 떠서 멈춘 상태라면 먼저 끄고 위 명령을 실행하세요.

kill -CONT $(pgrep EvoMac); kill $(pgrep EvoMac)

이 명령은 evo.app 하나에만 적용되는 것으로, 다른 앱에는 쓰지 마세요. Apple Developer ID 서명·공증이 적용되면 이 항목은 더 이상 필요하지 않습니다.

로그인

1. 창 오른쪽 위 계정 메뉴에서 “조직 계정으로 로그인…” 또는 “개인 계정으로 로그인…“을 고릅니다.
2. 창에 나온 코드를 확인하고 “브라우저 열기”를 누릅니다. 코드는 복사 버튼으로 복사할 수 있습니다.
3. 브라우저에서 로그인을 마치면 앱에 모델 목록이 채워집니다.

로그인하지 않으면 입력창에 “로그인이 필요합니다”가 보이고 메시지를 보낼 수 없습니다. 마지막에 쓴 계정은 다음 실행 때 자동으로 이어지며, 로그아웃은 같은 계정 메뉴에서 합니다.

0.2.7부터는 개인 계정으로 로그인해도 사용 기록이 evo 서비스(evo-api)로 기본 전송됩니다(조직 계정은 이전부터 전송). 처음 한 번 안내가 뜨고, 끄는 방법은 사용 기록에 있습니다.

세션 시작

1. “새 세션…”(⌘N)을 누르고 작업할 폴더를 고릅니다.
2. “이 폴더를 신뢰합니까?“에서 “신뢰하고 열기”를 누릅니다. 에이전트가 그 폴더에서 파일을 바꾸고 명령을 실행하므로 믿을 수 있는 폴더만 엽니다.
3. 입력창에 할 일을 적고 ⌘↩ 또는 “보내기”를 누릅니다. 실행 중에는 “중지”로 멈출 수 있습니다.

답은 실시간으로 이어서 나옵니다. “생각 과정”은 접혀 있고, 실행한 도구와 결과(완료·중지됨·턴 한도·오류, 턴 수, 입력·출력 토큰)가 카드로 보입니다.

왼쪽 목록에는 열린 세션 묶음과, 닫힌 세션을 마지막 활동 날짜로 나눈 오늘·어제·지난 7일·지난 30일·이전 묶음이 보입니다(제목, 폴더, 바꾼 시각). 묶음 머리를 눌러 접거나 펼 수 있습니다. 세션을 최대 10개까지 함께 열어 두고 오갈 수 있습니다. 닫힌 세션을 누르면 읽기 전용 미리보기가 보이고, “열기”로 이어 갈 수 있습니다.

모델과 권한 모드

• 모델: 상태 줄의 모델 칩에서 고릅니다. 로그인한 계정이 제공하는 모델이 보이며, 따로 고르지 않으면 기본 모델(없으면 첫 모델)을 씁니다.
• 권한 모드: 상태 줄의 모드 칩에서 고르며 세션마다 저장됩니다. 화면에 보이는 이름은 영문(Evo CLI와 같음)입니다. 새 세션은 auto mode로 시작합니다.

모드	동작
default mode	읽기만 하는 작업은 바로 하고, 파일 변경·명령 실행은 묻습니다
edits mode	작업 폴더 안 파일 편집은 묻지 않고 합니다
plan mode	읽기만 하고 바꾸지 않습니다
auto mode	edits mode에 더해, 애매한 명령은 분류 모델이 자동으로 허용·차단을 판단합니다
yolo mode	묻지 않고 실행합니다. 주의해서 씁니다

자세한 동작과 화면 캡처는 사용 설명서를 보세요.

에이전트는 파일 읽기·쓰기·편집과 셸 명령을 쓰고, 로그인돼 있으면 웹 검색도 합니다.

도구 실행 승인

에이전트가 파일을 바꾸거나 명령을 실행하려 하면 승인 창에 도구, 명령, 이유가 보입니다. “한 번 허용”, “이 세션 동안 허용”, “거부” 중에서 고릅니다. 실수로 승인하지 않도록 Enter로 바로 승인되지 않습니다.

설정

앱 메뉴 → 설정(⌘,)에서 “개인 계정 사용 기록 보내기”를 켜고 끌 수 있습니다(기본 꺼짐). 조직 계정은 사용 기록을 항상 보냅니다. 설정 화면에서 앱 버전도 확인할 수 있습니다.

알아 둘 점

• 업데이트는 앱 메뉴의 “업데이트 확인…“으로 받습니다(새 버전이 있으면 도구 막대에도 표시됩니다). dmg를 새로 받아 다시 설치할 필요는 없습니다.
• 업데이트 창의 “정식판으로 옮기기…”(개발판에서)·“개발판으로 옮기기…”(정식판에서)로 줄을 바꿀 수 있습니다. 지금보다 낮은 버전이어도 그 줄로 옮겨 설치되며, 세션과 설정은 그대로 남습니다.
• 서명·공증이 없는 임시(Ad-hoc) 서명이라 판마다 서명이 달라, 업데이트할 때마다 macOS 키체인 접근을 다시 물을 수 있습니다. “항상 허용”을 누르면 그 판에서는 다시 묻지 않습니다.
• 0.2.8부터 앱에서 워크플로우 작업(Issue 초안·게시, MR, 파이프라인, 저장소 설정)을 합니다. /workflow 메뉴로 시작하고, 자세한 내용은 워크플로우에 있습니다.
• 세션 기록은 ~/Library/Application Support/evo-mac/에, 로그인 정보는 macOS 키체인에 저장됩니다.
• 알려진 제한: Intel Mac(macOS 15)에서 설치 뒤 “그래도 열기”로 열면 Dock 아이콘만 뛰고 창이 뜨지 않을 수 있습니다. 브라우저로 받은 격리 표시 때문이며 앱 자체의 결함은 아닙니다. 위 “그래도 열기”로 열리지 않으면의 명령을 한 번 실행하면 됩니다. Apple Silicon Mac은 영향이 없습니다.

더 보기

화면 구성, 세션 관리, 입력 편의, 모델·권한 모드, MCP·evo-dispatch, 설정 전체 탭 등 전체 사용법은 사용 설명서를 보세요.