ur 시리즈
AI와 함께 쓰는 법
ur 시리즈는 명령줄(CLI), API, AI 에이전트가 쓰는 MCP, 사람이 쓰는 화면(UI) 네 가지 입구를 똑같이 갖고 있습니다. 그래서 사람과 AI가 같은 작업을 주고받으며 이어서 할 수 있습니다.
네 가지 입구로 같은 일을 합니다
버튼으로 하는 일마다 같은 일을 하는 '명령'이 있습니다. 사람은 화면에서 버튼을 누르고, AI 에이전트는 MCP로 명령을 부르고, 개발자는 명령줄에서 한 줄로 부르고, 다른 프로그램은 API로 부릅니다. 어느 입구로 하든 결과는 똑같습니다.
우리는 이 방식을 CAMU(CLI·API·MCP·UI)라고 부릅니다.
사람과 AI가 주고받으며 일합니다
사람
화면에서 보고 고칩니다
AI 에이전트
바뀐 결과를 읽고 이어 갑니다
AI에게 맡기고 끝나는 게 아닙니다. AI가 해 둔 일을 사람이 화면에서 보고 고치고, 사람이 고치거나 더한 것을 AI가 다시 읽어 들여 다음 일을 이어 갑니다.
예를 들어 AI가 압축 파일을 풀어 폴더를 정리해 두면, 사람은 화면에서 확인하고 몇 개를 옮기거나 이름을 고칩니다. AI는 사람이 바꾼 결과를 다시 읽고 그다음 일을 이어 갑니다.
그래서 ur 프로그램은 AI가 한 일이 화면에 그대로 보이고, 사람이 화면에서 바꾼 것도 AI가 그대로 읽을 수 있게 만듭니다.
예를 들면 이렇습니다
UrZip이렇게 말하면
“다운로드 폴더의 회의자료.zip에 뭐가 들었는지 보고, 문서만 꺼내 줘”
이렇게 됩니다
AI가 압축 파일 안을 먼저 살펴보고, 문서 파일만 골라서 풉니다.
AI가 쓰는 명령:
archive_listextract_planextract_smart
UrSnap이렇게 말하면
“지금 화면을 캡처해서 저장 버튼에 빨간 화살표를 그려 줘”
이렇게 됩니다
AI가 화면을 캡처하고, 저장 버튼 자리에 빨간 화살표를 그린 다음 파일로 저장합니다.
AI가 쓰는 명령:
capture.fullScreeneditor.annotatefile.save
어떤 명령을 어떤 순서로 쓸지는 AI 도구가 알아서 정합니다.
안전하게 쓸 수 있도록 이렇게 만들었습니다
- 내 컴퓨터 안에서 보낸 명령만 받습니다. 다른 컴퓨터에서는 명령을 보낼 수 없습니다.
- 프로그램을 켤 때마다 새 비밀번호를 만들고, 끄면 지웁니다. 이 비밀번호를 모르는 프로그램은 명령을 보낼 수 없습니다.
- 인터넷 웹 페이지가 몰래 명령을 보내려 해도 받지 않습니다.
- 파일 지우기나 덮어쓰기처럼 되돌리기 어려운 일은 확인을 거쳐야만 실행됩니다.
다만 내 컴퓨터에 이미 들어와 있는 악성 프로그램까지 막아 주지는 못합니다. AI 연결을 쓰지 않는다면 각 프로그램의 설정에서 꺼 둘 수 있습니다.
ur 프로그램은 내 파일을 인터넷 어디에도 올리지 않습니다. 다만 함께 쓰는 AI 도구가 어떤 내용을 자기 서버로 보내는지는 그 AI 도구의 설정에 달려 있습니다.
연결하는 법
프로그램마다 연결하는 방법이 조금 다릅니다. 아래에서 쓰려는 프로그램의 방법을 따라 하세요.
UrBuddy
Mac에서 AI 도구에 연결하기
메뉴 막대의 UrBuddy 아이콘 메뉴 › AI 연결에서 [Claude Code에 MCP 연결]이나 [Claude Desktop에 MCP 연결]을 누릅니다. 한 번 연결하면 이 Mac에 설치된 ur 프로그램 전부를 AI가 함께 씁니다. Claude Code는 새로 시작하는 대화부터, Claude Desktop은 완전히 끝냈다가(⌘Q) 다시 열면 쓸 수 있습니다.
"$HOME/Library/Application Support/ur/bin/ur" hub setup claude-code터미널에서 연결하려면 위 명령을 실행합니다. UrBuddy를 한 번 실행해 두어야 이 명령이 생깁니다.
터미널 명령으로 쓰기
Windows에서는 설치할 때 "명령줄에서 urbuddy 쓰기"를 켜 두면, 설치한 뒤 새로 연 터미널(명령을 글자로 입력하는 창)에서 urbuddy 명령을 쓸 수 있습니다. 아래 명령을 실행하면 쓸 수 있는 명령 목록이 나옵니다.
urbuddy helpMac에서는 UrBuddy 설정 › 정보에서 명령줄 연결을 켜면 같은 명령을 쓸 수 있습니다.
켜져 있는 프로그램에 직접 시키기
UrBuddy가 켜져 있는 동안에는 AI 도구가 UrBuddy에 직접 명령을 보낼 수 있습니다. 같은 컴퓨터에서 보낸 명령만 받습니다.
UrZip
Mac에서 AI 도구에 연결하기
메뉴 막대의 도움말 › AI 연결에서 [Claude Code에 MCP 연결]이나 [Claude Desktop에 MCP 연결]을 누릅니다. 한 번 연결하면 이 Mac에 설치된 ur 프로그램 전부를 AI가 함께 씁니다. Claude Code는 새로 시작하는 대화부터, Claude Desktop은 완전히 끝냈다가(⌘Q) 다시 열면 쓸 수 있습니다.
"$HOME/Library/Application Support/ur/bin/ur" hub setup claude-code터미널에서 연결하려면 위 명령을 실행합니다. UrZip을 한 번 실행해 두어야 이 명령이 생깁니다.
Windows에서 AI 도구에 등록해 쓰기
쓰고 있는 AI 도구의 설정에 UrZip을 한 번 등록해 두면, 그 뒤로는 AI가 필요할 때 UrZip을 알아서 씁니다. 등록할 때 넣는 명령은 아래와 같습니다(MCP 방식).
"%LOCALAPPDATA%\Programs\UrZip\urzip.exe" mcpurzip이라는 이름만으로는 실행되지 않으니, 위처럼 설치 폴더 경로까지 함께 입력합니다. 명령 프롬프트(cmd)에는 그대로 붙여 넣으면 됩니다. 위 경로는 기본 설치 위치이고, 설치할 때 "모든 사용자"를 골랐다면 C:\Program Files\UrZip\urzip.exe입니다.
터미널 명령으로 쓰기
터미널(명령을 글자로 입력하는 창)을 다룰 줄 아는 AI 도구는 UrZip에 명령을 내려 일을 시킬 수 있습니다. UrZip 창을 켜 두지 않아도 됩니다. Windows에서는 아래 명령을 실행하면 쓸 수 있는 명령 목록이 나옵니다(경로는 위와 같습니다).
"%LOCALAPPDATA%\Programs\UrZip\urzip.exe" helpMac에서는 도움말 › AI·자동화로 쓰기 창에서 이 Mac의 실행 파일 경로와 예시를 복사할 수 있습니다.
켜져 있는 프로그램에 직접 시키기
UrZip이 켜져 있는 동안에는 AI 도구가 UrZip에 직접 명령을 보낼 수 있습니다. 같은 컴퓨터에서 보낸 명령만 받습니다.
UrSnap
Mac에서 AI 도구에 연결하기
도움말 메뉴나 메뉴 막대의 UrSnap 아이콘 메뉴 › AI 연결에서 [Claude Code에 MCP 연결]이나 [Claude Desktop에 MCP 연결]을 누릅니다. 한 번 연결하면 이 Mac에 설치된 ur 프로그램 전부를 AI가 함께 씁니다. Claude Code는 새로 시작하는 대화부터, Claude Desktop은 완전히 끝냈다가(⌘Q) 다시 열면 쓸 수 있습니다.
"$HOME/Library/Application Support/ur/bin/ur" hub setup claude-code터미널에서 연결하려면 위 명령을 실행합니다. UrSnap을 한 번 실행해 두어야 이 명령이 생깁니다.
터미널 명령으로 쓰기
터미널(명령을 글자로 입력하는 창)을 다룰 줄 아는 AI 도구는 UrSnap 실행 파일 이름 뒤에 명령을 붙여 실행합니다. Windows에서는 아래 명령을 실행하면 쓸 수 있는 명령 목록이 나옵니다.
"%LOCALAPPDATA%\Programs\UrSnap\UrSnap.exe" helpUrSnap이라는 이름만으로는 실행되지 않으니, 위처럼 설치 폴더 경로까지 함께 입력합니다. 명령 프롬프트(cmd)에는 그대로 붙여 넣으면 됩니다. Mac에서는 도움말 › AI·자동화로 쓰기 창에서 이 Mac의 실행 파일 경로와 예시를 복사할 수 있습니다.
켜져 있는 프로그램에 직접 시키기
UrSnap이 켜져 있는 동안에는 AI 도구가 UrSnap에 직접 명령을 보낼 수 있습니다. 같은 컴퓨터에서 보낸 명령만 받습니다.
개발자를 위한 자세한 설명
- 명령은 127.0.0.1에서만 받습니다. 다른 컴퓨터에서는 접속할 수 없습니다.
- 앱을 켤 때마다 새 토큰을 만들어 사용자 폴더의 api.json에 적고, 앱을 끄면 지웁니다. 요청에는 Authorization: Bearer <토큰>이 있어야 합니다.
- Origin·Host 헤더를 검사해 브라우저 페이지가 보낸 요청을 거절합니다.
- 명령마다 danger 표시가 있고, 위험한 명령은 confirm: true 가 있어야 실행합니다.
- GET /v1/commands 로 명령 목록과 인수를 받습니다. 종료 코드의 뜻은 세 앱이 같습니다.
- 명령 목록: urbuddy help · urzip.exe help · UrSnap.exe help. UrBuddy는 설치할 때 고르면 PATH에 들어가고, UrZip·UrSnap 설치 프로그램은 PATH를 바꾸지 않습니다(기본 설치 폴더 %LOCALAPPDATA%\Programs\<앱>).