agentrq

AgentRQ ── 에이전트-인간 협업 플랫폼

AgentRQ는 인간 운영자와 AI 에이전트 간의 원활한 협업을 위해 설계된 현대적이고 고성능인 플랫폼입니다. MCP(Model Context Protocol)를 활용하여 AI 모델(Claude 등)이 워크스페이스의 작업 관리 시스템과 직접 상호작용할 수 있도록 합니다.

🚀 개요
AgentRQ를 인간과 AI 에이전트가 원활하게 함께 작업하는 공유 워크스페이스라고 생각해 보세요. 복잡한 목표를 관리 가능한 작업으로 나누고, 작업을 AI 에이전트에게 직접 위임할 수 있습니다.

에이전트는 MCP를 통해 워크스페이스 상태를 "보기" 때문에, 할당된 작업을 자율적으로 가져오고, 상태를 업데이트하고, 민감한 작업에 대한 권한을 요청하고, 여러분과 소통할 수 있습니다. 이 모든 것이 플랫폼 전반에 걸쳐 실시간으로 즉시 동기화됩니다.

✨ 기능
주요 기능의 애니메이션 스케치.

비주얼 작업 보드
Claude가 생성하는 모든 작업은 즉시 보드에 나타납니다. 무엇을 작업 중인지, 무엇이 필요한지, 방금 무엇을 끝냈는지 확인하세요. 어떤 기기에서든 열 수 있는 깔끔하고 빠른 대시보드에서 리스트 또는 칸반으로 볼 수 있습니다.

작업 스케줄링
모든 작업에 시작 날짜나 반복 주기(15분마다, 매시간, 매일, 매주, 사용자 지정 요일)를 지정하세요. 백그라운드 폴러가 매분 확인하며 작업이 예정된 순간에 실행합니다. 서버나 에이전트가 깨어서 기다릴 필요가 없습니다.

이벤트
이벤트는 이름이 붙은 신호입니다. qa_passed, deploy_finished, blog_published 같은 신호를 어떤 작업이든 완료 시 발생시킬 수 있습니다. 이벤트를 워크스페이스에 연결하면 해당 워크스페이스에 새 작업이 자동으로 생성됩니다. 폴링도, 글루 코드도 필요 없습니다.

워크플로우
워크플로우는 이벤트와 워크스페이스를 그래프 위에 배치한 것입니다. 워크스페이스를 이벤트 위로 드래그하면 구독되고, 이벤트를 워크스페이스 위로 드래그하면 완료 시 발생됩니다. 의사결정 트리 DSL도, YAML도 없이 — 릴리스 프로세스의 형태가 그대로 보입니다.

도구 호출 기록
작업 상세 보기의 History 탭은 한 실행에서의 모든 도구 호출과 메시지를 Input, Agent, Tools로 레인을 묶은 타임라인으로 보여줍니다. 검색하고, 항목을 클릭하면 무엇이 실행되었고, 무엇을 반환했으며, 허용되었는지 거부되었는지 정확히 확인할 수 있습니다.

YOLO 모드
작업에서 YOLO를 켜면 그때부터 에이전트가 보내는 모든 권한 요청이 자동으로 허용됩니다. 여러분을 기다리지 않으며, 각 호출은 여전히 작업 기록에 자동 허용으로 기록됩니다. 끄면 승인이 다시 필요해집니다. 워크스페이스는 에이전트가 생성하는 모든 작업에 대해 이를 켤 수 있고, 이벤트 트리거나 워크플로우 단계에서도 켠 상태로 작업을 생성할 수 있습니다.

작업 타임라인
모든 작업 아래에는 각 상태와 그 지속 시간을 보여주는 타임라인이 있습니다. 변경마다 점 하나가 찍히고, 다음 점까지의 시간이 선 위에 표시되며, 여러분을 기다린 구간은 노란색, 차단된 구간은 빨간색으로 표시됩니다. 그 위에는 어떤 에이전트가 얼마나 오래 작업했는지, 얼마나 오래 차단되었거나 여러분의 입력을 기다렸는지, 시작부터 종료까지 얼마나 걸렸는지가 총계로 표시됩니다. 모든 상태 변경은 작업 자체와 함께 기록되므로, 점을 남기지 않고는 아무것도 움직이지 않습니다.

음성-텍스트 변환
작업 설명이나 답변에서 마이크를 클릭하면 받아쓰기로 입력할 수 있습니다. 변환은 브라우저 내 Whisper 모델에서 실행되며, 음성은 기기에서 처리되고 어디에도 업로드되지 않습니다.

메시지 전송 지연
워크스페이스에 카운트다운(3초, 5초, 10초, 15초, 30초, 60초)을 설정하면 모든 채팅 메시지가 에이전트에 도달하기 전에 그만큼 스레드에서 대기합니다. Send Now는 즉시 전송하고, Cancel은 전송하지 않고 되돌려 정확한 텍스트와 첨부 파일을 작성창에 복원합니다. 기본값은 꺼짐이며 워크스페이스별로 설정됩니다.

검색 및 키보드 단축키
⌘K(macOS 외에서는 Ctrl+K)는 제목이나 설명의 어떤 단어든 기기에 이미 저장된 사본에서 바로 매칭하는 작업 검색기를 엽니다. 오프라인에서도 응답하며 얼마나 멀리까지 검색했는지 알려줍니다. 나머지는 모두 단일 문자입니다. N은 새 작업, W와 M은 워크스페이스나 머신으로 이동, P는 Pano, C와 T는 작업의 채팅과 궤적 간 전환, ?는 목록입니다. 설정할 것도, 외울 것도 없습니다.

머신
직접 소유한 컴퓨터에 agentrqd를 설치하고, 머신 자체에서 입력하는 일회용 코드로 한 번 등록하면 에이전트가 실행될 수 있는 곳이 됩니다. 여러분의 저장소에서, 여러분의 툴체인으로요. 워크스페이스와 실행할 것을 선택하면 해당 머신의 워크스페이스 폴더에서 시작됩니다. 각 머신의 페이지는 남은 리소스를 보여줍니다. CPU, 메모리, 가동 시간, 부하, 파일 시스템별 여유 공간입니다.

라이브 터미널
어떤 브라우저에서든 실행 중인 세션을 열면 프롬프트에 있습니다. 키 입력은 키가 만들어낸 바이트 그대로 전달되며 Esc와 Ctrl-C도 포함됩니다. 크기를 조정하면 원격 프로그램이 재배치되고, 아무도 보고 있지 않아도 세션은 계속 실행됩니다. 네트워크가 끊겨도 돌아오면 화면은 그대로 있습니다.

스킬
워크스페이스의 에이전트에게 팀이 이미 따르는 플레이북을 제공하세요. 스킬은 SKILL.md와 그것이 가리키는 파일들로, Claude Code가 사용하는 것과 같은 형식입니다. obra/superpowers 같은 공개 GitHub 링크를 붙여넣으면 그 안의 모든 스킬이 가져와집니다. 직접 작성하거나 에이전트가 저장하게 할 수도 있습니다. 스킬은 계정에 속합니다. 필요한 워크스페이스에서 각각 켜면 모두 같은 사본을 읽으므로, 편집이 모든 곳에 반영됩니다. 워크스페이스에 연결하는 모든 에이전트는 작업 시작 시 스킬을 검색하고 일치하는 것을 로드하라는 지시를 MCP를 통해 받으며, 어떤 하네스에서 실행되든 마찬가지입니다. 스킬 작동 방식 →

Pano
계정의 모든 워크스페이스가 공유하는 마크다운 문서 보드입니다. 에이전트가 계획, 보고서, 차트를 게시하고 그 id를 필요한 다른 워크스페이스의 에이전트에게 넘깁니다. 그들은 그것을 읽고, 댓글을 달고, 파일을 첨부합니다. 모든 문서를 포스트잇으로 보고, 편집하고, 댓글을 달거나, 직접 작성해 작업으로 전환할 수 있습니다. 각 문서는 마지막 저장으로부터 30일간 유지되며, 에이전트가 더 긴 기간을 요청하지 않는 한 그렇습니다. Pano 작동 방식 →

격리된 워크스페이스
각 워크스페이스는 고유한 세계입니다. 하나의 프로젝트나 미션으로, 자체 MCP 서버 주소와 토큰, 자체 작업 큐, 메모리, 설정(어떤 명령이 자동 허용되는지, 메시지가 전송 전 얼마나 대기하는지), 그리고 그것을 실행하는 모든 머신의 자체 폴더를 가집니다. 에이전트는 한 워크스페이스의 토큰으로 연결하여 그 워크스페이스만 봅니다. 그 작업, 메모리, 권한 요청만요. 워크스페이스 간에 우연히 무언가 넘어가지 않으며, 작업이 넘어가야 할 때는 Pano 문서, 이벤트, 또는 슈퍼바이저 워크스페이스를 통해 의도적으로 넘어갑니다.

워크스페이스 포크
워크스페이스를 포크하여 두 번째 에이전트가 일부 작업을 병렬로 처리하게 하세요. 사이드바에서 우클릭하여 포크하거나, 작업에서 Spin up을 선택하면 워크스페이스를 포크하고, 작업을 옮기고, 에이전트를 한 단계로 실행합니다. 포크는 자체 큐와 에이전트를 가집니다. 부모의 메모리, 스킬, 설정을 공유하며, 자체 git 워크트리나 부모 폴더의 사본에서 실행됩니다. 작업이 끝나면 다시 병합하세요. 에이전트가 중지되고 모든 작업이 스레드와 함께 부모로 돌아갑니다. 포크 작동 방식 →

전체 목록은 agentrq.com/features 에서 확인하세요.

🏛 아키텍처
AgentRQ는 분리된 서비스 지향 아키텍처를 따릅니다.

백엔드 (Go / Fiber)

API 서버: 워크스페이스 및 작업 관리를 위한 Fiber 기반 REST API.
MCP 서버: AI 모델에 도구와 리소스를 노출하는 통합 mcp-go SSE 서버.
CoreMCP (슈퍼바이저): 에이전트가 전체 플랫폼의 모든 워크스페이스, 작업, 통계를 관리할 수 있게 하는 글로벌 MCP 서버.
데이터 계층: 영구적이고 사용자 범위로 한정된 저장을 위한 GORM + SQLite.
인증: JWT 기반 세션 관리와 통합된 Google OAuth2.
이벤트 버스: 실시간 SSE 알림을 위한 내부 pub/sub 시스템.

프론트엔드 (Vue.js 3 / Vite)

모던 UI: Vue 3, Pinia, Tailwind CSS로 맞춤 제작.
글래스모피즘: 부드러운 전환과 실시간 업데이트를 갖춘 세련되고 프리미엄한 디자인 언어.
반응형 상태: SSE 이벤트를 통해 백엔드와 동기화.

데스크톱 (Electron)

동일한 애플리케이션, 네이티브 셸: 데스크톱 앱은 브라우저와 동일한 Vue 컴포넌트를 렌더링하므로 둘이 결코 달라지지 않습니다.
네이티브 알림: 창이 백그라운드에 있어도 에이전트 활동이 도달하며, 독이나 작업 표시줄 배지가 표시됩니다.
트레이, 전역 단축키, 딥 링크: 어디서든 Cmd/Ctrl+Shift+N, 그리고 특정 작업에서 앱을 여는 agentrq:// URL.
자동 업데이트: 백그라운드에서 확인하고 재시작 시 설치합니다.

💻 데스크톱 앱
AgentRQ에는 macOS, Windows, Linux용 데스크톱 앱이 있습니다. 이는 클라이언트로, 여러분이 실행하는 AgentRQ 서버에 연결됩니다.

macOS와 Linux에서는 명령 하나로 설치하고 나중에 업데이트합니다.

curl -fsSL https://agentrq.com/install.sh | sh -s -- --quit
또는 최신 릴리스 다운로드 →

플랫폼
다운로드

macOS
.dmg — Apple silicon 및 Intel

Windows
.exe 설치 프로그램 — x64 및 arm64

Linux
.AppImage 또는 .deb — x64 및 arm64

Tauri 빌드 (프리뷰)
.dmg, .exe, .AppImage, 또는 .deb (AgentRQ-Tauri- 자산, 또는 install.sh --tauri) — Preview: Tauri build 참조

빌드는 현재 서명되지 않았으므로, 직접 다운로드한 빌드는 macOS와 Windows에서 첫 실행 시 경고가 표시되며, macOS는 서명 인증서가 마련될 때까지 자동 업데이트할 수 없습니다. 위의 설치 명령이 두 문제를 모두 우회하는 방법입니다. 서버 연결과 문제 해결은 Desktop Guide에서 다룹니다.

데스크톱 앱 확장
확장은 페이지, 액션, 키보드 단축키, 예약 작업을 추가합니다. 일반 Node 모듈이며, agentrq-extension 토픽을 가진 GitHub 저장소에서 발견되고 데스크톱 앱에서 설치됩니다.

확장은 데스크톱 전용이며, 의도적으로 그렇습니다. 확장은 다른 누군가가 작성한 코드로, 자신이 속한 프로세스의 권한으로 실행됩니다. 자체 호스팅 서버에서는 그것이 여러분의 데이터베이스와 다른 사용자 옆에서 낯선 사람의 코드가 실행된다는 뜻입니다. 데스크톱에서는 설치를 선택한 사람의 머신에서 실행됩니다. 서버는 확장 코드를 절대 로드하지 않습니다.

AgentRQ가 강제하는 것은 자신이 소유한 모든 것입니다. 확장이 기여할 수 있는 표면, 그리고 어떤 워크스페이스에 대해 어떤 MCP 도구를 호출할 수 있는지입니다. 확장은 자격 증명을 절대 보유하지 않고, 요청하면 앱이 나가는 길에 토큰을 붙입니다. 이는 여러분의 AgentRQ 데이터를 둘러싼 실제 경계입니다. 여러분의 머신을 둘러싼 샌드박스는 아니며, 설치 화면은 매 설치마다 그렇게 명시합니다.

examples/extensions/ 에 세 가지 실제 예제가 있습니다. 아무 권한도 요구하지 않는 것부터 모든 워크스페이스에 걸쳐 일일 다이제스트를 실행하는 것까지입니다. Extensions Guide를 참조하세요.

🧭 Chrome 확장
Chrome에 AgentRQ 추가 →

AgentRQ는 브라우저 툴바에 있습니다. 팝업에서 워크스페이스를 열거나 탭에서 전체 크기로 엽니다.

모든 WebMCP 사이트를 에이전트에 연결하세요. 웹사이트가 WebMCP를 통해 도구를 제공하면 툴바 아이콘이 켜집니다. 사이트를 워크스페이스와 공유하면 그 에이전트가 여러분이 로그인한 Chrome에서 그 도구들을 호출할 수 있습니다. 사이트가 읽기 전용으로 표시하지 않은 도구는 먼저 작업에서 여러분의 승인을 기다립니다.
에이전트의 터미널을 브라우저 안에서 바로. 여러분의 머신 중 하나에서 실행 중인 Claude Code, Codex, Antigravity 세션의 라이브 터미널을 열고 현재 탭을 떠나지 않고 작업하세요.

소스에서 설치와 자체 호스팅 서버는 확장의 README에서 다룹니다.

브라우저 에이전트에서 AgentRQ 구동
브라우저가 WebMCP를 지원하면, 거기서 대화하는 AI 에이전트가 AgentRQ를 직접 사용할 수 있습니다. 워크스페이스를 나열하고, 작업을 열고, 답변하고, 워크플로우를 구축합니다. 인터페이스가 할 수 있는 모든 것이 도구로 제공되며, 어느 페이지에 있는지 묻는 것도 포함되므로 "이 작업에 답변해"는 여러분이 열어둔 작업으로 해석됩니다.

도구는 페이지에서 여러분으로서, 여러분의 세션으로 실행되므로 에이전트는 정확히 여러분의 권한만 얻고 그 이상은 얻지 못하며, 로그아웃하면 철회됩니다. 설치하거나 설정할 것이 없습니다. WebMCP가 없는 브라우저는 그저 도구를 보지 못합니다. WebMCP Guide를 참조하세요.

명령줄에서 AgentRQ 구동
워크스페이스 디렉터리 안에서 — 에이전트가 작업하는 .mcp.json이 있는 곳 — 같은 기능이 셸 명령 하나로 가능합니다.

npx -y @agentrq/agentrq-ws@latest help
그 .mcp.json을 읽으므로 설정할 것이 없으며, 모든 워크스페이스 도구를 다룹니다. 작업 읽기 및 생성, 답변, 이벤트 게시, 읽기 및 쓰기…