agentrq/agentrq

AgentRQ: Human-in-loop realtime conversational task manager for AI Agents. Self-hosted! Control your own agents from wherever you want Mobile, Web, Desktop. Designed to work well with your own Claude subscriptions and any harness with ACP support.

AgentRQ – 인간과 AI 에이전트를 위한 협업 플랫폼

개요 – AgentRQ는 인간 운영자와 하나 이상의 AI 에이전트(예: Claude, Antigravity, Codex)가 공통 작업 워크스페이스를 공유할 수 있도록 하는 오픈소스 셀프호스팅 웹/데스크톱 애플리케이션입니다. 이 플랫폼은 에이전트가 원격 도구 세트처럼 호출할 수 있는 Model Context Protocol(MCP) 서버를 노출합니다. 작업 생성, 상태 업데이트, 메시지 응답, 이벤트 발화, '메모리' 노트 읽기/쓰기 등이 가능합니다. 에이전트는 인간 UI와 동일한 상태를 볼 수 있으므로, 사용자가 루프에 머물면서 자율적으로 작업할 수 있습니다.

핵심 기능 (README에 설명된 내용)

기능	제공되는 것
시각적 작업 보드	에이전트가 생성한 모든 작업의 실시간 칸반/목록 보기. 상태, 요구사항 및 히스토리 포함.
작업 스케줄링	시작 날짜 또는 반복 주기(15분-시간-일-주-사용자 지정)를 지정합니다. 백그라운드 폴러가 기한이 되면 정확히 작업을 생성합니다 – 서버 측 '상시 가동' 에이전트 불필요.
이벤트 및 워크플로	다른 워크스페이스에서 새 작업을 트리거할 수 있는 이름 지정 시그널(`qa_passed`, `deploy_finished`, …). 드래그 앤 드롭 그래프 편집기로 YAML이나 DSL 없이 이벤트-워크스페이스 파이프라인을 구축.
도구 호출 히스토리	작업 실행 중 모든 도구 호출 및 채팅 메시지의 타임라인 보기. 검색 및 드릴다운 가능.
자동 제목 생성	작은 온디바이스 언어 모델(브라우저에 캐시, API 호출 없음)을 사용한 원클릭 제목 생성.
음성 인식	작업 설명 또는 응답을 위한 브라우저 내 Whisper 전사 – 로컬에서 처리되며 업로드되지 않음.
메시지 전송 지연	메시지가 에이전트에 도달하기 전의 선택적 카운트다운(3-60초). 취소 또는 즉시 전송 가능.
키보드 기반 UI	빠르고 마우스 없는 작업을 위한 글로벌 단축키(`⌘K`/`Ctrl+K` 작업 찾기, `N` 새 작업, `M/T` 채팅/트래젝토리 보기, `?` 도움말).

아키텍처 (고수준)

백엔드 – Go (Fiber) REST API + SSE 기반 MCP 서버(mcp-go). 데이터는 GORM을 통해 SQLite에 저장, 인증은 Google OAuth2 + JWT, 실시간 업데이트를 위한 내부 pub/sub.
프론트엔드 – Vue 3 + Vite, Pinia로 상태 관리, Tailwind CSS와 글래스모피즘 UI로 스타일링.
데스크톱 클라이언트 – 동일한 Vue UI를 실행하고 네이티브 알림, 트레이 메뉴, 글로벌 단축키, 딥링크 처리(agentrq://…), 자동 업데이트를 추가하는 Electron 래퍼.
확장 기능 – GitHub(agentrq-extension 토픽)에서 발견되는 데스크톱 전용 Node 모듈. 확장 기능은 페이지, 액션, 단축키, 예약 작업을 추가할 수 있습니다. 사용자 권한으로 실행되며 코어 앱에 의해 중개됩니다(서버 측 코드 실행 없음).

AI 에이전트가 AgentRQ와 통신하는 방법

MCP URL 및 토큰 – 각 워크스페이스는 고유한 MCP 엔드포인트를 게시합니다(https://<workspace>.mcp.agentrq.com/?token=…).
.mcp.json – 프로젝트 디렉터리에 배치; 에이전트가 어떤 MCP 서버를 사용할지 알려줍니다.
Claude 통합 – .claude/settings.local.json 파일로 MCP 도구 세트(createTask, reply, loadMemory 등)를 사전 승인하여 Claude Code가 매번 사용자에게 프롬프트하지 않고 작동할 수 있습니다.
ACP 게이트웨이 – Agent Client Protocol을 사용하는 에이전트(Antigravity, Codex)를 위해, @agentrq/acp-gateway가 ACP ↔ MCP를 브리지하며 인증, 작업 라우팅, 실시간 알림을 처리합니다.

시작하기 (README의 빠른 시작 단계)

전제 조건 – Go 1.21+, Node 18+, Google OAuth2 클라이언트 ID/시크릿.

클론 및 설치

git clone https://github.com/agentrq/agentrq.git
cd agentrq
make install          # Go 모듈, npm 패키지 등을 가져옴

로컬 실행

make dev               # 백엔드(Fiber)와 프론트엔드(Vite)를 함께 시작
# 데스크톱 UI를 위한 다른 터미널에서
make desktop-dev

UI는 http://localhost:5173에서 접근 가능합니다.

데스크톱 빌드 – 사전 빌드된 설치 프로그램은 릴리스 페이지에서 사용 가능하며, 또는 원라이너로 설치:
```
curl -fsSL https://agentrq.com/install.sh | sh -s -- --quit
```
셀프호스팅 – Docker 이미지와 SETUP.md가 프로덕션 준비가 된 compose 파일을 제공합니다.

일반적인 사용 사례

AI 지원 프로젝트 관리 – Claude가 티켓을 생성, 스케줄링, 업데이트하도록 하고 인간은 검토하고 때때로 명확화를 제공합니다.
지속적 통합 파이프라인 – 배포 후 검증 작업을 AI 리뷰어를 위해 자동으로 생성하는 이벤트(deploy_finished)를 발화합니다.
지식 베이스 구축 – 에이전트는 실행 간에 지속되는 memory.md(워크스페이스 노트)에 작성하여 누적 학습을 가능하게 합니다.
하이브리드 코딩 지원 – Codex 또는 Antigravity를 동일한 워크스페이스에 연결하여 작업 할당을 받고 코드 스니펫으로 응답합니다. 모든 것이 공유 대시보드에서 확인 가능합니다.

더 알아보기

전체 기능 목록: https://agentrq.com/features
데스크톱 가이드: docs/DESKTOP.md
확장 기능 개발: docs/EXTENSIONS.md
MCP 프로토콜 사양: 저장소에서 링크됨(WebMCP 통합)
ACP 게이트웨이 문서: docs/WEBMCP.md, docs/SLASH_COMMANDS.md

결론 – AgentRQ는 현대 LLM 에이전트를 인간 친화적인 작업 보드와 연결하고, 자율적이면서도 감독된 AI 작업을 위해 잘 정의된 도구 프로토콜(MCP)을 노출하는 구체적이고 프로덕션 등급의 플랫폼입니다. 완전히 오픈소스이며 셀프호스팅이 가능하며, 웹 및 네이티브 데스크톱 클라이언트를 모두 포함합니다.