시작하기

Evo CLI란

Evo CLI는 터미널에서 AI 에이전트와 대화하며 코드를 읽고 수정하고 명령을 실행하는 개발용 코딩 에이전트입니다. 명령 이름은 evo입니다. 대화형 화면(TUI)과 스크립트·CI용 비대화형 실행(-p)을 같은 엔진으로 제공하므로, 개발자와 자동화를 맡은 운영자 모두 사용할 수 있습니다.

설치

지원 운영체제는 Linux, macOS, Windows(x64·arm64)입니다.

한 줄 설치

설치 파일은 공개 Nexus 저장소 https://nexus.bluewindsky.com에 있습니다(로그인 필요 없음). 회사 밖에서 쓰거나 다른 설치 저장소를 운영하는 기관은 관리자가 안내한 저장소 주소를 같은 위치에 넣습니다.

Linux · macOS:

curl -fsSL https://nexus.bluewindsky.com/repository/evo-bin/install/install.sh | bash

Windows(PowerShell):

powershell -ExecutionPolicy ByPass -NoProfile -Command "irm https://nexus.bluewindsky.com/repository/evo-bin/install/install.ps1 | iex"

현재 정식판은 0.23.1입니다. 설치본의 버전은 evo --version으로 확인하고, 설치 파일 자체는 https://nexus.bluewindsky.com/repository/evo-bin/evo-cli/release/latest/VERSION에서도 확인할 수 있습니다.

• 특정 버전만 설치하려면 Linux·macOS는 bash -s -- --version <버전>을 붙입니다.
• 설치할 때 Node.js, glab, git이 없거나 오래되었으면 함께 설치합니다. 관리자 권한은 필요 없으며(git 제외), 끄려면 --no-deps를 붙입니다.
• 조직 사용자는 관리자가 알려 준 조직 이름을 --org-key <조직 이름>으로 붙이면 조직 키 파일이 함께 설치됩니다.

npm 설치

사내 npm 저장소를 @evomind scope에 지정한 환경에서는 npm으로도 설치할 수 있습니다.

npm install -g @evomind/evo

버전 확인

evo --version

처음 실행

작업할 폴더에서 evo를 실행합니다.

cd <프로젝트 폴더>
evo

• 처음 여는 폴더에서는 “이 폴더를 신뢰하는가”를 묻습니다. 폴더의 .evo/ 설정이 명령을 실행할 수 있으므로 믿을 수 있는 폴더에서만 허용하세요.
• Evo CLI는 로그인해야 모델을 사용할 수 있습니다. 화면에서 /login을 입력하거나 터미널에서 evo login을 실행하면 확인 주소와 코드가 표시되고, 브라우저에서 로그인한 뒤 코드를 승인하면 됩니다. 로그아웃은 /logout(또는 evo logout)입니다.
• 이미 로그인한 상태에서 /login을 입력하면 다시 로그인할지 먼저 묻습니다. 다른 계정으로 바꾸려면 다시 로그인을 고르세요.

일반 모드와 조직 모드

구분	조건	모델 설정
일반 모드	조직 키 파일(~/.evo/org.json) 없음	로그인 후 evo 모델을 쓰거나 /provider로 직접 모델 서버를 등록
조직 모드	조직 키 파일 있음	로그인하면 조직 모델이 자동 구성됨. /model로 허용된 모델 중에서 선택

조직 모드에서는 /provider로 모델을 직접 등록할 수 없습니다.

기본 사용

대화형 화면

evo를 실행하고 요청을 입력합니다. 주로 쓰는 명령은 다음과 같습니다.

입력	동작
/login, /logout	로그인, 로그아웃
/model	지금 쓰는 모델 서버의 모델 중에서 선택. 고른 모델은 다음에 시작할 때의 기본 모델이 됩니다. 다른 모델 서버로는 /provider에서 옮깁니다
/resume	이전 세션 목록을 열어 골라 이어 가기(↑/↓로 이동, Enter 선택, Esc 닫기)
/provider	모델 서버 등록·전환(일반 모드)
/status	세션 상태와 로그인 상태 확인
/config	설정 확인·변경(권한 모드, 생각 모드와 생각 수준 등)
/permissions	권한 모드 확인·변경
/update	업데이트
!<명령>	셸 명령을 바로 실행하고 결과를 대화에 전달. ! 바로 뒤가 숫자이면 셸 명령이 아니라 모델에 보냅니다
@<경로>	작업 폴더의 파일·폴더 목록에서 골라 넣으면, 보낼 때 그 파일 내용이 함께 갑니다

• 터미널에서 evo --resume만 입력해도 세션 목록이 열립니다. 한 세션은 evo 하나만 쓸 수 있어, 다른 터미널의 evo가 쓰고 있는 세션은 목록에 (in use)로 표시되고 열리지 않습니다.
• 하위 에이전트가 일하는 동안에는 입력창 위에 하위 에이전트마다 하는 일, 지금 쓰는 도구, 토큰, 걸린 시간이 표시됩니다.
• @를 치면 입력창 위에 파일·폴더 목록이 뜹니다. ↑/↓로 고르고 Tab이나 Enter로 넣으며, Esc로 닫습니다. 파일 이름 뒤에 조사가 붙어도(@main.go를) 그 파일을 찾습니다. 첨부하지 못한 파일은 @경로 not attached: … 줄로 알려 줍니다. evo -p에서는 @를 풀지 않습니다.
• ! 셸 명령과 모델이 실행하는 명령은 터미널과 떼어 실행합니다. sudo처럼 터미널에서 비밀번호를 묻는 명령은 기다리지 않고 바로 실패합니다.
• 실행 중 Esc나 Ctrl+C를 누르면 실행을 멈춥니다. 그래도 끝나지 않으면 Ctrl+C나 Ctrl+D를 한 번 더 누르면 evo가 바로 끝납니다.

도구 실행 확인 창

권한 규칙과 모드가 정하지 못한 명령은 실행하기 전에 테두리 창으로 묻습니다. 번호(또는 ↑/↓ 뒤 Enter)로 고릅니다.

선택지	뜻
Yes, once	이번 한 번만 허용
Yes, for this session	이 세션 동안 허용
Yes, always in this project	이 프로젝트에서 늘 허용. .evo/config.local.json에 저장됩니다
Yes, always for this user	이 사용자에게 늘 허용. ~/.evo/settings.json에 저장됩니다
No	거부

• 거부는 맨 끝 번호, n, Esc, Ctrl+C입니다.
• 저장할 규칙을 만들 수 없는 명령(파일 수정 등)에서는 “늘 허용” 두 줄이 빠지고 선택지가 줄어듭니다.

비대화형 실행(-p)

evo -p "이 저장소 구조를 요약해줘"
evo -p "테스트 실패 원인을 찾아줘" --output-format json --max-turns 10

플래그	설명
-p, --print	프롬프트를 실행하고 결과를 출력한 뒤 종료
--output-format	text(기본) | json | stream-json
--permission-mode	default | acceptEdits | plan | auto | bypassPermissions
--max-turns	모델 호출 횟수 상한. -p에서 기본 30
--allowed-tools	확인 없이 허용할 도구 규칙 (예: "Bash(npm run test:*)")
--model	사용할 모델
--resume <id>, --continue	지정한 세션 이어가기 / 가장 최근 세션 이어가기. -p에서는 id가 필요합니다

--permission-mode를 주지 않으면 설정을 따르고, 설정도 없으면 대화형은 auto, -p는 default입니다. -y(--yolo)는 모든 도구를 확인 없이 실행하고 샌드박스를 끄므로, 위험을 이해하는 격리된 환경에서만 사용하세요.

종료 코드

코드	의미
0	성공
1	실행 오류
2	사용법 오류
3	--max-turns 초과

도구 없이 모델과 대화만 하려면 evo chat "질문"을 사용합니다.

업데이트

evo update --check   # 새 버전 확인 (최신이면 종료 코드 0, 새 버전이 있으면 10)
evo update           # 업데이트

대화형 화면에서는 /update로도 할 수 있으며, 시작할 때 새 버전이 있으면 알려 줍니다. 삭제는 evo uninstall입니다.

0.21.0 이하에서는 evo update로 최신 버전에 올라올 수 없습니다(업데이트가 오류로 실패합니다). 한 줄 설치로 다시 설치하세요. 설정과 세션은 그대로 남습니다.

개발판(develop 머지마다 나오는 X.Y.Z-dev.N)을 쓰려면 설치할 때 --dev(PowerShell -Dev)를 붙입니다. evo update --release로 정식판으로, 정식판에서 evo update --dev로 다시 개발판으로 옮깁니다. 자세한 내용은 상세 사용법을 보세요.

폐쇄망

외부 인터넷이 차단된 기관은 기관용 바이너리를 반입해 설치하고 기관 내부 저장소에서 업데이트합니다. 바이너리 반입, 내부 저장소 구성, 폐쇄망에서 쓸 수 없는 기능은 폐쇄망 설치와 업데이트를 참고하세요.

더 보기

• 상세 사용법: 모든 플래그, 권한 모드, 설정, 세션, 훅 등
• 폐쇄망 설치와 업데이트
• 조직 키 파일: 조직 키 파일의 서명과 배포