ELOP Crew

PC 프로그램 설치

ELOP Crew PC 프로그램은 Windows와 macOS용 무료 데스크톱 앱입니다. 터미널 없이 창과 트레이로 돌아갑니다. 앱 없이 소스에서 바로 실행할 수도 있습니다.

설치 전에

  • Claude Code가 설치돼 있고 로그인돼 있어야 합니다. 새 PC에는 이것만 있으면 됩니다.
  • 지금은 Claude Code만 지원합니다. OpenAI Codex, Gemini CLI 등도 지원할 예정입니다.
  • 설치 파일은 다운로드에서 받습니다. 모두 GitHub 릴리스에 올라가 있습니다.

Windows에 설치

  1. Setup .exe를 받아 실행합니다.
  2. 코드 서명이 없어서 SmartScreen이 경고할 수 있습니다. 그러면 추가 정보 → 실행을 누릅니다.
  3. 지금 사용자 계정에만 설치되므로 관리자 권한은 필요 없습니다. 설치가 끝나면 바로 켜집니다.
  4. 처음 켤 때 Claude Code 훅을 설치할지 묻습니다. 설치를 누릅니다.

macOS에 설치

  1. Apple 실리콘(M1 이후)이면 arm64, 인텔 Mac이면 x64 디스크 이미지(.dmg)를 받습니다.
  2. 디스크 이미지를 열고 앱을 응용 프로그램 폴더로 끌어다 놓습니다. 다른 곳에서 켜면 먼저 응용 프로그램 폴더로 옮길지 묻습니다. 훅이 앱의 위치를 기억하기 때문입니다.
  3. Apple 개발자 ID 서명이 없어서 처음 켤 때 "개발자를 확인할 수 없습니다"로 막힙니다. 우클릭 → 열기로 한 번 열거나, 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기에서 허용합니다.
  4. 처음 켤 때 훅을 설치할지 묻습니다. 설치를 누릅니다.

Claude Code 훅

훅은 Claude Code가 특정 순간마다 실행하는 작은 프로그램입니다. ELOP Crew는 훅으로 승인 요청과 질문을 받아 오고, 세션의 권한 모드를 알아내고, 화면에서 보낸 메시지를 세션에 전달합니다. 리더에게 팀원을 알려 주는 것도 훅이 합니다.

  • 앱은 ~/.claude/settings.json에서 ELOP Crew 항목만 추가하거나 바꿉니다. 다른 설정과 훅은 그대로 둡니다.
  • 원래 파일은 settings.json.before-agent-monitor로 남겨 둡니다.
  • Node.js가 있으면 훅은 Node.js로, 없으면 앱 자체로 돌아갑니다.
  • 설치하면 이미 실행 중인 Claude Code 세션에도 바로 적용됩니다.

처음에 나중에를 눌렀다면 설정의 Claude Code hook 칸에서 설치/갱신을 누르면 됩니다. 이 칸은 설치됨, 갱신 필요, 설치 안 됨 가운데 하나를 보여 줍니다. 앱이 새 기능을 담은 훅을 내놓으면 갱신할지 한 번 더 묻습니다.

훅이 없어도 대시보드는 세션을 보여 줍니다. 다만 VS Code 세션의 승인 요청에 답하기, 권한 모드 표시, 화면에서 메시지 보내기는 되지 않습니다.

창과 트레이

  • 창 위쪽의 얇은 제목 줄에 ← → ⟳(뒤로, 앞으로, 새로 고침), − 100% +(확대·축소), ⚙(설정)가 있습니다. 이 줄을 잡고 끌면 창이 움직입니다.
  • 확대·축소는 버튼, Ctrl + 휠, Ctrl + − / 0 / =로 하고, 비율은 기억합니다. Alt + ← / →와 F5도 됩니다.
  • Claude 사용량이 있으면 제목 줄에 세션 45% · 주간 29%처럼 나옵니다. 누르면 계정 창이 열립니다. 사용량 보기
  • 창은 마지막 자리와 크기 그대로 열립니다.
  • 창을 닫으면 트레이로 숨고 에이전트는 계속 돕니다. 트레이 메뉴에는 열기, 설정, 프로그램 정보, 종료가 있습니다. 종료하면 ELOP Crew가 띄운 에이전트도 멈춥니다.

macOS에서는 창 버튼이 제목 줄 왼쪽에 있고, Ctrl 대신 ⌘를 씁니다. 트레이 대신 메뉴 막대 아이콘이 있습니다. Dock 아이콘을 누르면 창이 다시 열리고, ⌘ Q는 종료하면서 에이전트도 멈춥니다.

트레이 메뉴, 설정 창, 프로그램이 띄우는 안내는 대시보드에서 고른 언어를 따릅니다.

설정

제목 줄의 ⚙이나 트레이 메뉴의 설정…으로 엽니다.

로그인할 때 자동 시작PC에 로그인하면 창 없이 트레이에서 조용히 시작합니다.
창을 닫으면 트레이로끄면 창을 닫을 때 앱이 종료되고, ELOP Crew가 띄운 에이전트도 멈춥니다.
창 불러오기 단축키어디서든 눌러 창을 띄우는 키입니다. 아래를 보세요.
데이터 폴더config.json, 작업판(boards/), 에이전트 목록이 있는 곳입니다. 기본은 ~/.claude-agent-monitor입니다. 열기와 바꾸기…가 있고, 바꾼 폴더는 앱을 다시 시작하면 씁니다.
Claude Code hook훅 상태와 설치/갱신 버튼입니다.
업데이트지금 상태와 지금 확인 버튼입니다. 받아 둔 새 버전이 있으면 설치하고 다시 시작이 나옵니다.
정보버전, 프로그램 정보, 브라우저에서 열기입니다.

창 불러오기 단축키

기본은 Ctrl + Alt + J(macOS는 ⌃⌥J)입니다. 누르면 창이 뜨고 키 입력이 화면으로 가므로, 바로 숫자 키로 맨 앞 승인 요청에 답할 수 있습니다. 한 번 더 누르면 숨깁니다.

설정에서 Ctrl + Alt + M, Space, K로 바꾸거나 끌 수 있습니다. 다른 프로그램이 이미 그 키를 쓰면 설정 창이 알려 줍니다.

업데이트

  • Windows: 켤 때와 6시간마다 GitHub 릴리스를 확인합니다. 새 버전은 뒤에서 받아 두었다가 다음에 다시 켤 때 설치합니다. 트레이 메뉴나 설정에서 바로 설치할 수도 있습니다.
  • macOS: 서명되지 않은 앱에는 업데이트를 설치할 수 없어서, 새 버전이 나오면 알림·메뉴·설정으로 알려 주기만 합니다. 받으러 가기를 누르면 릴리스 페이지가 열립니다.

업데이트하는 동안 일하던 에이전트는 다시 켜진 뒤 하던 일을 이어 갑니다. 재시작과 로그인

소스로 실행하기

앱 없이 Node 18 이상만으로, 의존성 없이 돌아갑니다.

git clone https://github.com/elopstudio/elop-crew
cd elop-crew
npm start     # http://127.0.0.1:4777

브라우저에서 http://127.0.0.1:4777을 엽니다. 포트는 PORT=…로 바꿀 수 있습니다. 화면은 기본이 영어이고, 메뉴에서 한국어로 바꾸거나 ?lang=ko를 붙여 엽니다.

  • 소스로 실행할 때는 훅을 직접 ~/.claude/settings.json에 넣어야 합니다. 넣을 내용은 README에 있습니다.
  • 데이터 폴더는 코드 폴더이고, MONITOR_HOME으로 바꿀 수 있습니다.
  • 휴대폰 앱에서 이 PC에 연결하려면 Node 22 이상이 필요합니다. PC 연결하기
  • 앱이 켜질 때 그 포트에서 이미 ELOP Crew가 돌고 있으면, 앱은 새로 띄우지 않고 그쪽을 보여 줍니다.

Agent Monitor에서 옮겨 올 때

이 프로그램의 예전 이름은 Agent Monitor입니다. 업데이트해도 설정, 이름, 작업판이 그대로 이어집니다.

  • Windows: 설치 폴더, 프로그램 파일(Agent Monitor.exe), 로그인 시 시작 항목은 그대로 두고 바로 가기 이름만 바뀝니다.
  • macOS: 새로 받은 ELOP Crew.app이 예전 Agent Monitor.app 옆에 놓이고 같은 설정을 씁니다. 예전 앱을 지우면 새 앱이 훅을 다시 설치할지 묻습니다. 로그인할 때 자동 시작을 켜 두었다면 설정에서 다시 켜 주세요.

설치가 끝났으면 대시보드 둘러보기로 넘어가세요. 잘 안 되면 문제 해결을 보세요.

삭제하기

  1. Claude Code 훅 빼기 — 먼저 ~/.claude/settings.json(Windows는 %USERPROFILE%\.claude\settings.json)을 열어 hooks 안에서 명령에 hooks/bridge.mjs 또는 hooks/inbox.mjs가 들어간 항목을 지웁니다. 남겨 두면 프로그램을 지운 뒤 Claude Code가 훅을 못 찾아 오류를 띄웁니다. 처음 훅을 설치할 때 원래 파일을 settings.json.before-agent-monitor로 남겨 두었지만, 그 뒤 바꾼 설정까지 되돌아가므로 직접 지우는 편이 낫습니다.
  2. 휴대폰 앱을 쓰던 PC라면 연결 해제 — 계정 창이나 계정 페이지에서 이 PC를 해제합니다. 연결 해제하기
  3. 자동 시작 끄기 — 설정의 로그인할 때 자동 시작을 끕니다.
  4. 프로그램 지우기 — Windows는 설정 → 앱 → 설치된 앱에서 ELOP Crew(예전 버전은 Agent Monitor)를 제거합니다. macOS는 응용 프로그램 폴더의 ELOP Crew(또는 Agent Monitor)를 휴지통으로 옮깁니다.
  5. 남은 데이터 지우기(선택) — 프로그램을 지워도 데이터는 남습니다. 완전히 지우려면 ~/.claude-agent-monitor(작업판, 이름, 설정, PC 연결 키)와 앱 설정 폴더(Windows %APPDATA%\Agent Monitor, macOS ~/Library/Application Support/Agent Monitor)를 지웁니다. Claude Code 자신의 대화 기록은 건드리지 않습니다.

Install the PC program

The ELOP Crew PC program is a free desktop app for Windows and macOS. It runs in a window and the tray, with no terminal. You can also run it straight from the source code.

Before you start

  • You need Claude Code, installed and signed in. That is all a new PC needs.
  • Claude Code is the only agent supported today. OpenAI Codex, Gemini CLI and others are on the way.
  • Get the installer from Download. Every version is on GitHub Releases.

Install on Windows

  1. Download Setup .exe and run it.
  2. The installer is not code-signed, so SmartScreen may warn you. Click More info → Run anyway.
  3. It installs for your user account only, so no admin rights are needed. It starts as soon as it is done.
  4. On first run it offers to install the Claude Code hooks. Accept.

Install on macOS

  1. Download the arm64 disk image (.dmg) for Apple silicon (M1 and later), or x64 for an Intel Mac.
  2. Open it and drag the app to Applications. If you start it from anywhere else, it offers to move itself there first, because the hooks remember where the app is.
  3. The app is not signed with an Apple Developer ID, so macOS refuses the first start ("cannot verify the developer"). Open it once with right-click → Open, or allow it in System Settings → Privacy & Security → Open Anyway.
  4. On first run it offers to install the hooks. Accept.

The Claude Code hooks

Hooks are small programs Claude Code runs at certain moments. ELOP Crew uses them to receive permission requests and questions, learn each session's permission mode, and deliver the messages you send from the dashboard. They also tell a project's leader who is on its team.

  • The app adds or replaces only its own entries in ~/.claude/settings.json. Your other settings and hooks are left alone.
  • A backup of the file is kept as settings.json.before-agent-monitor.
  • With Node.js on the PC the hooks run on it; without, they run on the app itself.
  • Claude Code sessions that are already running pick them up straight away.

If you said no on first run, open the settings and use the install / update button in the hooks section. That section shows whether the hooks are installed, need an update, or are missing. When a new version ships hooks with new features, the app asks once more.

Without the hooks the dashboard still shows your sessions, but you cannot answer a VS Code session's requests from it, see the permission modes, or send messages from the page.

The window and the tray

  • A thin title strip at the top holds ← → ⟳ (back, forward, reload), − 100% + (zoom) and ⚙ (settings). Drag the strip to move the window.
  • Zoom with the buttons, Ctrl + mouse wheel, or Ctrl + − / 0 / =; the level is remembered. Alt + ← / → and F5 work too.
  • When Claude usage numbers are known, the strip shows your session and weekly percentages. Click them to open the account dialog. Usage
  • The window opens where you left it, at the same size.
  • Closing the window hides it in the tray and your agents keep running. The tray menu has open, settings, about and quit. Quitting also stops the agents ELOP Crew started.

On a Mac the window buttons sit at the left of the strip and the shortcuts use ⌘ instead of Ctrl. The menu bar icon does what the tray does. Clicking the Dock icon brings the window back; ⌘ Q quits and stops the agents.

The tray menu, the settings window and the app's messages follow the language you pick on the dashboard.

Settings

Open them with ⚙ in the title strip, or from the tray menu.

Start at loginStarts quietly in the tray, without a window, when you log in.
Close to the trayTurned off, closing the window quits the app and stops the agents ELOP Crew started.
Window shortcutThe key that brings the window up from anywhere. See below.
Data folderWhere config.json, the boards (boards/) and the agent list live. The default is ~/.claude-agent-monitor. You can open it or pick another one; a new folder is used after the app restarts.
Claude Code hooksTheir state, and a button to install or update them.
UpdatesThe current state and a button to check now. When a new version is downloaded, a button installs it and restarts.
AboutThe version, the about dialog, and a button to open the dashboard in your browser.

The window shortcut

By default it is Ctrl + Alt + J (⌃⌥J on a Mac). It brings the window up with the keyboard on the dashboard, so the number keys answer the first request right away. Press it again to hide the window.

In the settings you can switch to Ctrl + Alt + M, Space or K, or turn it off. If another program already has the key, the settings window says so.

Updates

  • Windows: the app checks GitHub Releases at start and every six hours, downloads a new version in the background and installs it the next time it starts. You can also install it at once from the tray or the settings.
  • macOS: macOS only installs updates into a signed app, so the Mac app just tells you a new version is out (a notification, the menu, the settings) and opens the release page for you to download it.

Agents that were in the middle of work during an update carry on once the app is back. Restarts and sign-in

Run it from source

All it needs is Node 18 or later; there are no dependencies.

git clone https://github.com/elopstudio/elop-crew
cd elop-crew
npm start     # http://127.0.0.1:4777

Open http://127.0.0.1:4777 in your browser. Set PORT=… for another port. The page is in English by default; switch in its menu, or add ?lang=ko for Korean.

  • Run this way, you add the hooks to ~/.claude/settings.json yourself. The entries are in the README.
  • The data folder is the code folder, unless you set MONITOR_HOME.
  • For the phone app to reach this PC you need Node 22 or later. Linking a PC
  • If ELOP Crew is already answering on that port when the desktop app starts, the app shows that one instead of starting another.

Coming from Agent Monitor

The program used to be called Agent Monitor. Updating keeps your settings, names and boards.

  • Windows: the install folder, the program file (Agent Monitor.exe) and the start-at-login entry stay as they were; only the shortcuts are renamed.
  • macOS: the new ELOP Crew.app sits beside the old Agent Monitor.app and uses the same settings. Once you delete the old app, the new one offers to install the hooks again. If start at login was on, turn it on again in the settings.

Installed? Continue with The dashboard. If something does not work, see Troubleshooting.

Uninstalling

  1. Take the Claude Code hooks out: first open ~/.claude/settings.json (on Windows %USERPROFILE%\.claude\settings.json) and, under hooks, delete the entries whose command contains hooks/bridge.mjs or hooks/inbox.mjs. Left in place, they make Claude Code report a missing hook once the program is gone. The original file was kept as settings.json.before-agent-monitor when the hooks were first set up, but restoring it also undoes any setting you changed since, so deleting the entries is better.
  2. Unlink the PC if you used the phone app: unlink it in the account window or on the account page. Unlinking
  3. Turn off starting at login: switch off Start at login in the settings.
  4. Remove the program: on Windows, Settings → Apps → Installed apps, ELOP Crew (Agent Monitor in older versions), Uninstall. On macOS, move ELOP Crew (or Agent Monitor) from Applications to the Bin.
  5. Remove what is left (optional): the data stays after the program is gone. To remove everything, delete ~/.claude-agent-monitor (the board, names, settings and the PC's link key) and the app's settings folder (Windows %APPDATA%\Agent Monitor, macOS ~/Library/Application Support/Agent Monitor). Claude Code's own conversation history is not touched.