메인 콘텐츠로 바로가기

앱·파일 검색

UrBuddy

유어버디

개인·기업 모두 무료미리보기 버전

앱과 파일을 키보드로 바로 찾아 엽니다.

개인도 기업도 무료로 쓸 수 있습니다.

2026.11.20 · Windows 10·11용 0.1.5(80MB) · macOS용 0.1.3(34MB)

정식 버전이 나오기 전에 먼저 써 볼 수 있는 미리보기 버전입니다.

UrBuddy 검색창에 앱 이름을 입력한 화면

받기

  1. 설치 파일 받기

    [무료로 받기]를 눌러 설치 파일을 받습니다. 파일 이름은 UrBuddy-0.1.5-win-x64-setup.exe입니다.Mac에서는 파일을 받지 않고, 터미널에 아래 한 줄을 붙여 넣어 설치합니다.curl -fsSL https://urai.kr/apps/install.sh | sh -s urbuddy

  2. 경고가 뜨면

    새로 나온 프로그램이라 Windows가 경고 창을 띄울 수 있습니다. 경고 창이 뜨면 바로 아래 “설치하다 막혔나요?”에서 같은 화면을 골라 따라 하세요.

  3. 처음 켜기

    Alt+Space를 누르면 검색창이 뜹니다. 찾을 이름을 입력하고 Enter를 누릅니다. 다른 프로그램이 이미 Alt+Space를 쓰고 있다면 UrBuddy 설정에서 다른 키로 바꿀 수 있습니다. Mac에서는 ⌘Space로 엽니다. Spotlight와 겹치면 ⌥Space로 바꾸는 안내가 뜹니다.

설치하다 막혔나요?

지금 내 화면에 뜬 것과 같은 그림을 고르세요. 어디를 누르면 되는지 알려 드립니다.

Mac을 쓰면: Mac에 설치하기

화면

  • 초성으로 앱을 찾은 결과 목록
    초성만 입력해도 앱을 찾습니다.
  • 파일 내용에서 나들이를 찾은 결과(파일 이름과 줄 위치)
    파일은 이름으로도, 내용으로도 찾습니다.
  • 검색창에서 계산식을 계산한 결과
    계산식을 입력하면 바로 답이 나옵니다.
  • 전에 복사한 글 목록
    전에 복사한 글을 골라 다시 붙여 넣습니다.
  • UrBuddy 설정 창의 일반 화면(화면 모드·테마)
    화면 모드와 테마는 설정에서 바꿉니다. UrBuddy를 여는 키는 설정의 단축키에서 바꿉니다.

하는 일

앱 찾아 열기

  • 초성만 입력해도, 띄어쓰기를 틀려도 찾아 줍니다.
  • 이미 켜져 있는 앱은 새로 열지 않고 그 창을 앞으로 가져옵니다.
  • 자주 쓰는 것과 최근에 쓴 것이 목록 위쪽에 나옵니다.

파일 찾기 — 이름으로, 내용으로

  • PC 안에 있는 디스크 전체에서 파일을 이름으로 찾습니다.
  • 검색어 앞에 "내용"이라고 쓰면 파일 속 글까지 찾아보고, 검색어가 들어 있는 줄을 미리 보여 줍니다.

계산과 단위 바꾸기

  • 계산식을 입력하면 바로 답이 나오고, Enter를 누르면 답이 복사됩니다.
  • 길이, 무게 같은 단위도 바꿔 줍니다.

복사한 글 다시 쓰기

  • 전에 복사한 글을 목록에서 골라 다시 붙여 넣습니다.
  • 복사 기록은 이 PC에만 암호화해서 저장합니다. 기록을 시작하기 전에 먼저 알려 드립니다.

다른 ur 프로그램 열기

  • "화면 캡처"처럼 하려는 일을 입력하면 그 일을 하는 ur 프로그램을 찾아 엽니다.
  • 아직 설치하지 않은 ur 프로그램은 UrBuddy 안에서 바로 설치할 수 있습니다.

AI·자동화로 쓰기

  • Mac에서는 메뉴 막대의 UrBuddy 아이콘 메뉴에서 Claude Code·Claude Desktop에 한 번 연결하면, AI가 이 Mac의 ur 프로그램을 함께 씁니다.
  • 화면에서 하는 일을 AI 도구, 터미널 명령, 다른 프로그램에서도 똑같이 시킬 수 있습니다.
  • 아이콘 메뉴 › AI·자동화로 쓰기 창에서 쓰는 법과 복사할 예시를 한곳에서 봅니다.

AI에게 시키기

앱 찾기, 계산, 복사 기록 보기처럼 UrBuddy로 하는 일을 AI 도구에게 맡길 수 있습니다.

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에 직접 명령을 보낼 수 있습니다. 같은 컴퓨터에서 보낸 명령만 받습니다.
  • AI 도구가 명령을 보내지 못하게 하려면 UrBuddy 설정에서 이 기능을 끄면 됩니다.
AI와 함께 쓰는 법

필요한 것

Windows

  • Windows 10·11, 64비트
  • 함께 설치해야 하는 다른 프로그램은 없습니다
  • 관리자 권한이 없어도 설치할 수 있습니다(내 계정에만 설치됩니다)

macOS

  • macOS 14 이상, Apple Silicon·Intel 모두
  • 함께 설치해야 하는 다른 프로그램은 없습니다
  • Dock이 아니라 화면 위쪽 메뉴 막대에 아이콘이 생깁니다

설정과 데이터가 저장되는 곳

Windows

설정·복사 기록
%APPDATA%\urbuddy\
검색을 빠르게 하려고 만들어 두는 파일
%LOCALAPPDATA%\urbuddy\Cache\
작동 기록(로그)
%LOCALAPPDATA%\urbuddy\Logs\

macOS

설정·즐겨찾기·별칭
~/Library/Application Support/urbuddy/
검색을 빠르게 하려고 만들어 두는 파일
~/Library/Caches/urbuddy/
작동 기록(로그)
~/Library/Logs/urbuddy/

지우는 법

Windows

  1. Windows 설정 › 앱 › 설치된 앱에서 UrBuddy를 찾아 [제거]를 누릅니다.
  2. 프로그램을 지워도 설정과 기록은 남습니다. 깨끗이 지우려면 위 "설정과 데이터가 저장되는 곳"의 폴더도 지우세요.

macOS

  1. 메뉴 막대의 UrBuddy 아이콘 › UrBuddy 종료를 누릅니다.
  2. 설정 › 일반에서 "로그인 시 실행"을 켰다면 먼저 끕니다.
  3. 응용 프로그램 폴더의 UrBuddy를 휴지통으로 옮깁니다. 설정과 기록까지 지우려면 위 "설정과 데이터가 저장되는 곳"의 폴더도 지우세요.

알아 둘 것

  • 새 버전은 이 페이지에 올립니다. 프로그램이 새 버전을 알려 주지는 않으니 가끔 이 페이지를 확인해 주세요.
  • 처음 실행하면 파일 검색을 준비하느라 시간이 조금 걸립니다.
  • Mac에서 바탕 화면·문서·다운로드 폴더의 파일도 찾으려면 처음 한 번 접근을 허용해야 합니다. 검색 창에 뜨는 안내에서 [허용하기]를 누르세요.
  • Windows 11의 "스마트 앱 컨트롤"이 켜진 PC에서는 아직 실행할 수 없습니다. 자세한 내용은 설치 도움말에 있습니다.

바뀐 점

  1. 0.1.5 · 2026.11.20

    바뀜

    • 명령 목록(Windows Ctrl+K, Mac ⌘K)을 열면 아무것도 치지 않아도 "AI·자동화로 쓰기"가 한 줄 보입니다. Claude Code·Claude Desktop 연결·끊기는 "MCP"·"연결"처럼 글을 쳐서 찾을 때 나옵니다.
    • UrBuddy가 꺼져 있을 때 ur로 부르면 응답이 끝나지 않고 멈추던 Windows 문제를 고쳤습니다(동봉 ur 0.1.2).
  2. 0.1.4 · 2026.11.20

    Windows만 — 맥 0.1.3에 먼저 들어간 기능을 Windows에도 넣었습니다(맥은 0.1.3 그대로). 개인·회사 모두 무료이고, 아직 코드 서명이 없어 처음 설치할 때 Windows 경고가 뜹니다(넘기는 법: https://urai.kr/apps/install-help).

    추가 — Windows: AI·자동화로 쓰기

    • 알림 영역의 UrBuddy 아이콘 메뉴에 AI 연결이 생겼습니다: Claude Code에 MCP 연결·Claude Desktop에 MCP 연결(연결돼 있으면 … 연결 끊기)·AI·자동화로 쓰기…. 메뉴를 열 때 지금 상태를 다시 읽어, 연결된 것은 "끊기"만, 아닌 것은 "연결"만 누를 수 있습니다.
    • 한 번 연결하면 이 PC에 설치된 ur 앱 전부(UrBuddy·UrSnap·UrZip …)를 Claude에서 함께 씁니다. Claude Code는 새로 시작하는 세션부터(/mcp에 ur가 보여요), Claude Desktop은 알림 영역 아이콘 › 종료로 완전히 끈 뒤 다시 열면 적용됩니다.
    • 끊기 전에 확인 창이 뜹니다 — "끊으면 이 앱뿐 아니라 ○○도 Claude에서 함께 빠져요". 설정 파일이 깨져 바꾸지 못하면 이유와 함께 설정 조각 복사 단추와 붙여 넣을 파일 위치를 보여 줍니다.
    • AI·자동화로 쓰기 창: 연결 상태, 명령줄 예시(복사), 로컬 API, 화면 단축키, 안내서를 한곳에 모았습니다. 설정 › ur 도구 맨 위와 검색 창 명령(Ctrl+K, "MCP"로 찾기)에서도 엽니다.
    • 공용 ur 실행기를 설치 폴더 안(ur\ur.exe)에 함께 싣고, 켤 때 %LOCALAPPDATA%\ur\bin\ur.exe에 놓습니다(없거나 더 새 판일 때만 — 옛 판이 새 판을 덮지 않아요). UrBuddy를 지워도 다른 ur 앱의 AI 연결은 그대로입니다.
    • 명령 4개 app.interfaces·mcp.status·mcp.connect·mcp.disconnect(끊기는 확인이 필요한 명령), 로컬 API GET /v1/help와 GET /v1의 help 칸, 명령줄 urbuddy --help(끝에 "다른 입구")·urbuddy help interfaces [--json](앱이 꺼져 있어도 답해요). 어디에도 API 암호(토큰) 값은 싣지 않습니다.
    • AI 도구 등록 정보에 안내서 5개(한눈에 보기 한·영, AI, 확장, 테마)와 명령마다 이름·종류·실행 방식을 함께 싣습니다 — Claude가 UrBuddy 명령을 더 잘 고릅니다.

    바뀜 — Windows

    • 명령 이름 9개가 바뀌었습니다(두 낱말은 이어 쓰기): launcher.new-window → launcher.newWindow 등(아래 0.1.3 "바뀜 — 공통"과 같음). 옛 이름도 2027-02-15까지 그대로 동작하고, 쓰면 경고를 알려 줍니다.
    • AI가 파일을 바꾸거나 명령을 실행하기 전에 묻는 화면의 말을 "허락"에서 "허용"으로 맞췄습니다.
    • 검색창에 ai 로 시작하는 말을 쳐도 그 말로 시작하는 명령·별칭이 있으면 검색 결과에 머뭅니다(예: ai 자 → "AI·자동화로 쓰기"). AI 도구가 없을 때의 안내는 "AI 도구 설치가 필요해요"로, 맨 아래에 "Claude에서 UrBuddy를 쓰려면 → AI·자동화로 쓰기" 줄이 생겼습니다.
    • 로컬 API GET /v1(앱 이름·버전만)은 암호 없이 답합니다 — ur 실행기가 UrBuddy가 켜져 있는지 알아보는 길이에요. 다른 주소는 그대로 암호가 필요합니다. 명령줄은 인수를 파일로 받는 @<파일>과 --no-input을 알아듣습니다(ur 실행기가 앱 없이 부를 때).
    • UrBuddy 안 AI가 일하는 중에 AI 연결(mcp.connect)을 하려 하면 매번 묻습니다("이 대화 동안 허용" 없음). AI 연결 끊기는 AI가 할 수 없고 화면에서만 합니다.
  3. 0.1.3 · 2026.11.18

    macOS만 — Windows판은 다음 판에(Windows는 0.1.2 그대로). 맥 판 번호는 이제 mac/VERSION에 따로 둔다.

    추가 — macOS: AI·자동화로 쓰기(네 입구)

    • 메뉴 막대 UrBuddy 아이콘 메뉴에 AI 연결 묶음: Claude Code에 MCP 연결·Claude Desktop에 MCP 연결(연결돼 있으면 … 연결 끊기)·AI·자동화로 쓰기…. 메뉴를 열 때 지금 상태를 다시 읽어 연결된 것은 "끊기"만, 아닌 것은 "연결"만 켠다.
    • 한 번 연결하면 이 맥에 설치된 ur 앱 전부(UrBuddy·UrSnap·UrZip …)를 Claude에서 함께 쓴다. 연결 뒤 안내: Claude Code는 새로 시작하는 세션부터(/mcp에 ur), Claude Desktop은 완전히 종료(⌘Q)했다가 다시 열면 적용.
    • 끊기 전에 확인 창 — "끊으면 이 앱뿐 아니라 ○○도 Claude에서 함께 빠져요". 실패하면 오류와 설정 조각 복사 단추·붙여 넣을 파일 위치.
    • AI·자동화로 쓰기 창: 연결 상태·명령줄 예시(복사)·로컬 API·화면·안내서를 한 곳에. 설정 › 정보와 런처 명령 목록(⌘K·"MCP"로 찾기)에서도 연다.
    • 명령 넷 app.interfaces·mcp.status·mcp.connect·mcp.disconnect(끊기는 위험 명령 — 확인 필요). 명령 182 → 186(맥 184).
    • 로컬 API GET /v1/help(= app.interfaces, 토큰 필요)와 GET /v1의 help 칸. 어디에도 토큰 값은 싣지 않는다.
    • 명령줄 urbuddy help interfaces [--json](앱이 꺼져 있어도 답함)와 urbuddy --help 끝 "다른 입구".
    • 공용 ur 실행기를 앱 안(Contents/Helpers/ur)에 싣고, 처음 실행할 때(그리고 새 판일 때만) ~/Library/Application Support/ur/bin/ur에 놓는다. 옛 판이 새 판을 덮지 않는다. dmg 안에서 바로 연 경우에는 놓지 않는다(응용 프로그램 폴더로 옮긴 뒤 첫 실행 때).
    • AI 도구 등록(~/Library/Application Support/ur/registry/urbuddy.json)에 안내서(overview 한·영·ai·extensions·themes)를 함께 싣는다.

    바뀜 — 공통(Windows·macOS)

    • 명령 이름 9개가 바뀌었다(두 낱말은 이어 쓰기): launcher.new-window → launcher.newWindow, launcher.alias-save → launcher.aliasSave, launcher.commands-run → launcher.commandsRun, launcher.pick-folder → launcher.pickFolder, launcher.backdrop-probe → launcher.backdropProbe, settings.app-commands → settings.appCommands, settings.index-clear → settings.indexClear, settings.record-shortcut → settings.recordShortcut, system.recycle-bin → system.recycleBin. 옛 이름도 당분간(2027-02-15 또는 다음 다음 버전까지) 그대로 동작하고, 쓰면 경고를 알려 준다.
    • AI가 파일을 바꾸거나 명령을 실행하기 전에 묻는 화면의 말을 "허락"에서 "허용"으로 맞췄다("허용을 기다려요", "1건 허용 안 함" 등 — 단추 "한 번 허용"과 같은 말).

    바뀜 — macOS

    • 키 표시에서 Esc를 ⎋로 쓴다(다른 키 기호와 같은 모양).
    • 런처의 모드 줄도 글자 배율을 따르지 않는다(런처 전체가 같은 크기). 설정 창은 그대로 배율을 따른다.

    추가 — macOS(Swift로 새로 만든 첫 맥판)

    • 메뉴 막대에 상주하는 런처: 호출 키(기본 ⌘Space, Spotlight와 겹치면 ⌥Space로 바꾸는 카드)로 열고 앱·명령을 키보드로 찾아 실행한다.
    • 한글 검색: 초성(ㅁㅁㅈ)·겹자음·띄어쓰기 무시·부분 일치, 자주·최근 쓴 앱이 위로.
    • 실행 중인 앱은 그 창으로 전환, ⇧Enter로 새 창. 즐겨찾기·별칭·숨기기, ⌘K 명령 팝오버, ⌘/ 단축키 안내.
    • 계산(Enter로 복사), 주소·경로 열기, 웹 검색 키워드(n 날씨 등)와 기본 검색 엔진.
    • 파일 이름 검색: 맥 전체 디스크 범위·외장 디스크·위치/종류/수정일 조건, 바탕 화면·문서·다운로드는 허용을 받은 뒤에만.
    • 파일 본문 검색(in 또는 내용 ): 한글 1~2자도 찾고, ⌘Y로 일치한 줄 미리보기.
    • 설정 창: 테마·배경 투명도·로그인 시 실행·호출 키와 명령별 전역 키 녹화·즐겨찾기·앱 목록·웹 검색·검색 범위·정보.
    • 명령줄 도구 urbuddy와 AI 도구 연결(ur-agent API) — 화면에서 하는 일을 명령으로도 한다. 설정 › 정보에서 /usr/local/bin/urbuddy 연결.
    • 설치본: Apple Silicon·Intel 유니버설 UrBuddy-0.1.0-mac-universal.dmg·.zip·SHA256SUMS.txt, 앱 아이콘·메뉴 막대 아이콘.
    • AI 도구 등록: 처음 실행할 때 ~/Library/Application Support/ur/registry/urbuddy.json에 자기 정보를 남긴다(다른 ur 도구·AI가 찾을 수 있게).
    • ur 도구 찾기·실행: "화면 캡처"처럼 할 일 이름으로 ur 도구를 찾고, 설치된 도구는 창 없이 띄워 바로 실행한다. 설치하지 않은 도구는 조용한 줄(최대 두 줄)로 보여 준다. 파일 행 ⌘K에 그 파일을 받는 ur 도구가 나온다.
    • 런처 안 설치·업데이트: 설치 필요 줄에서 Enter → 확인 카드 → 받기(진행 막대)·파일 확인 → dmg를 열어 응용 프로그램 폴더(쓸 수 없으면 내 응용 프로그램 폴더)에 놓는다. 받은 파일이 올린 것과 같은지 확인한 뒤 설치하고, 끝나면 받은 파일을 지운다.
    • ur 도구 자동 업데이트(도구가 꺼져 있을 때만, 저전력 모드·종량제에서는 쉼)·도구 목록 새로 받기(하루 한 번). 설정 › ur 도구에서 끌 수 있다.

    알아 둘 것 — macOS

    • 아직 Apple 서명·공증이 없다. 처음 열 때 우클릭 › 열기(또는 xattr -cr /Applications/UrBuddy.app)가 필요하다(README "macOS 설치").
    • 새 버전 알림은 아직 없다.

의견 보내기

쓰다가 불편한 점이나 바라는 점이 있으면 프로그램 안의 "의견 보내기"나 아래 버튼으로 알려 주세요.

의견 보내기

만든 사람 Carami, ToTo, Esther