메인 콘텐츠로 바로가기

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 help

    Mac에서는 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" mcp

    urzip이라는 이름만으로는 실행되지 않으니, 위처럼 설치 폴더 경로까지 함께 입력합니다. 명령 프롬프트(cmd)에는 그대로 붙여 넣으면 됩니다. 위 경로는 기본 설치 위치이고, 설치할 때 "모든 사용자"를 골랐다면 C:\Program Files\UrZip\urzip.exe입니다.

  • 터미널 명령으로 쓰기

    터미널(명령을 글자로 입력하는 창)을 다룰 줄 아는 AI 도구는 UrZip에 명령을 내려 일을 시킬 수 있습니다. UrZip 창을 켜 두지 않아도 됩니다. Windows에서는 아래 명령을 실행하면 쓸 수 있는 명령 목록이 나옵니다(경로는 위와 같습니다).

    "%LOCALAPPDATA%\Programs\UrZip\urzip.exe" help

    Mac에서는 도움말 › 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" help

    UrSnap이라는 이름만으로는 실행되지 않으니, 위처럼 설치 폴더 경로까지 함께 입력합니다. 명령 프롬프트(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\<앱>).