UseAgent

<h1 align="center"> <img src="https://raw.githubusercontent.com/useagenthq/useagent/HEAD/docs-site/public/useagent-mark.svg" alt="" width="48" valign="middle"> UseAgent </h1> 오픈 소스 Devin 대안입니다. Claude Code, Codex, OpenCode 또는 Pi를 격리된 클라우드 작업 공간에서 자체 호스팅할 수 있습니다. Slack, 웹 또는 API에서 작업을 위임하고 풀 리퀘스트와 파일을 받으세요. <a href="https://github.com/useagenthq/useagent/releases"><img src="https://img.shields.io/badge/status-alpha-orange.svg" alt="Status: alpha"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-purple.svg" alt="License: AGPL-3.0"></a> <a href="https://github.com/useagenthq/useagent/stargazers"><img src="https://img.shields.io/github/stars/useagenthq/useagent?style=flat" alt="GitHub stars"></a> <a href="https://github.com/useagenthq/useagent/issues?q=is%3Aopen+label%3Ahacktoberfest"><img src="https://img.shields.io/badge/Hacktoberfest-2026-ff8ae2.svg" alt="Hacktoberfest 2026"></a> <a href="https://useagent.org/docs/"><img src="https://img.shields.io/badge/docs-useagent.org-blue.svg" alt="Documentation"></a> <a href="#use-the-hosted-app"> · <a href="#self-hosting"> · <a href="https://useagent.org/#demo"> · <a href="https://useagent.org/docs/"> · <a href="#hacktoberfest-2026">

UseAgent는 Claude Code, Codex, OpenCode 및 Pi에게 리포지토리, 터미널, 브라우저 및 팀의 도구가 있는 공유 작업 공간을 제공합니다. 웹 앱, Slack 또는 API에서 연구, 웹사이트, 스프레드시트 또는 코드 변경을 요청하세요. 작업을 실시간으로 추적하고 필요할 때 개입하며 생성된 파일을 보관하세요.

<a href="https://useagent.org/#demo"> <img src="https://raw.githubusercontent.com/useagenthq/useagent/HEAD/docs/media/app-session.png" alt="UseAgent에서 에이전트 세션: 실시간 타임라인, 터미널 및 작업 공간 패널" width="960"> </a> <a href="https://useagent.org/#demo">63초 제품 투어 시청하기 →</a> 실제 제품 영상입니다. 로그인할 필요가 없습니다.

팀들이 UseAgent를 선택하는 이유

서버에서 실행됩니다. 전체 시스템을 모든 Linux 장치에 직접 호스팅할 수 있습니다. 사용자의 코드, 프롬프트 및 파일은 원래 위치에 보관되므로, 이는 컴플라이언스 팀이 가장 중요하게 여기는 부분입니다.

</td> <td width="50%" valign="top">

모든 실행 기록이 남습니다. Postgres는 각 단계, 도구 호출 및 승인 과정을 추가 전용 로그(append-only log)로 저장합니다. 모든 실행을 재생하고 누가 무엇을 승인했는지 확인하며, 작업 중간에 재시작되어도 문제가 없습니다.

</td> </tr> <tr style="border-bottom: 1px solid #eee;"> <td width="50%" valign="top">

이미 비용을 지불하고 있는 계정을 사용하세요. ChatGPT 플랜에서 Codex를 실행하거나, 모든 엔진의 API 키를 가져올 수 있습니다. 키는 서버에 보관되며 에이전트의 샌드박스로 절대 유입되지 않습니다.

</td> <td width="50%" valign="top">

에이전트는 바꾸고 나머지는 유지하세요. Claude Code, Codex, OpenCode 및 Pi는 하나의 이벤트 형식을 공유하므로, 엔진을 변경해도 스레드, 파일 및 메모리가 유지됩니다.

</td> </tr> </table>

알파 소프트웨어입니다. UseAgent는 실제 일일 워크로드를 실행하지만, API와 스키마는 릴리스 간에 변경될 수 있습니다. 안정성이 필요하면 태그를 고정하세요.

UseAgent와 Devin

	Devin	UseAgent
소스 코드	비공개(Closed)	오픈 소스 (AGPL)
...
UseAgent는 새로운 모델이 아니며, 모든 Devin 워크플로우를 대체할 증명된 대안도 아닙니다. 이는 사용자가 이미 사용하는 에이전트 주변의 작업 공간입니다: 작업당 컴퓨터, 팀의 도구 및 컨텍스트, 그리고 발생한 모든 일에 대한 완전한 기록을 제공합니다.

호스팅 앱 사용하기

설치나 신용카드 정보가 필요 없습니다. 여기서 시작하세요:

이메일로 app.useagent.org에 **가입(Sign up)**하세요.
홈 페이지에서 **스레드 시작(Start a thread)**하고 원하는 작업을 말해주세요: 웹사이트, 연구 보고서, 스프레드시트, 또는 저장소 중 하나를 수정하는 작업 등.
모델을 선택하세요. 무료 모델은 항상 이용 가능합니다. 모델 메뉴의 '무료 목록(Free list)'에서 하나를 골라 진행하세요.
이미 가지고 있는 계획을 가져오세요. **설정(Settings) → 제공업체 연결(Provider connections)**으로 이동하여 ChatGPT 계정을 연결하고 자체 플랜으로 Codex를 실행할 수 있습니다. 인도에서는 무료 ChatGPT Go 플랜도 작동합니다.
원할 때 더 많은 모델을 추가하세요. 같은 위치에 API 키를 붙여넣으세요. 키는 쓰기 전용(write-only)이며 에이전트의 샌드박스 내부로 절대 들어가지 않습니다.

에이전트가 브라우저와 터미널에서 작동하는 것을 지켜보고, 질문할 때 답변하고, 생성한 파일을 열어보세요.

기능(Features)

<table> <tr <td width="45%" valign="middle">

모든 스레드를 위한 컴퓨터(A computer for every thread)

에이전트가 실제 브라우저에서 연구하고, 명령을 실행하며, 저장소와 작업하는 것을 지켜보세요. 데스크톱이나 터미널을 열어 필요할 때 직접 제어할 수 있습니다.
Daytona과 CubeSandbox는 화면 녹화 기능이 있는 격리된 Linux 워크스테이션을 제공합니다.

컴퓨터 사용 및 샌드박스 →

</td> <td width="55%"> <a href="https://useagent.org/docs/concepts/sandboxes-and-desktop/"> <picture> <source media="(prefers-reduced-motion: reduce)" srcset="docs/media/demo-computer.jpg"> <source srcset="docs/media/demo-computer.gif" type="image/gif"> <img src="https://raw.githubusercontent.com/useagenthq/useagent/HEAD/docs/media/demo-computer.jpg" alt="에이전트가 브라우저 소스를 읽는 동안 그 도구 활동과 연구 스트림이 스레드로 흘러들어오는 모습" width="100%"> </picture> </a> </td> </tr <tr <td width="45%" valign="middle">

팀의 작업 방식 학습시키기

GitHub에서 스킬을 가져오고, 플레이북을 특정 태스크에 고정하며, 효과가 입증된 절차를 재사용할 수 있습니다. 스킬은 버전 관리(versioned)되므로, 실행 기록이 어떤 버전을 사용했는지 정확하게 기록합니다.

스킬 및 플레이북 →

</td> <td width="55%"> <a href="https://useagent.org/docs/product/skills-and-playbooks/"> <picture> <source media="(prefers-reduced-motion: reduce)" srcset="docs/media/demo-skills.jpg"> <source srcset="docs/media/demo-skills.gif" type="image/gif"> <img src="https://raw.githubusercontent.com/useagenthq/useagent/HEAD/docs/media/demo-skills.jpg" alt="공유 작업 공간에서 재사용 가능한 스킬과 팀의 지식을 탐색합니다." width="100%"> </picture> </a> </td> </tr> <tr> <td width="45%" valign="middle">

지속되는 컨텍스트(Context that carries forward)

지식, 위키 페이지, 그리고 선택적 팀 메모를 작업 옆에 보관합니다. 회상된 사실을 검토하고 수정하며, 개인 및 조직의 메모를 분리하여 관리할 수 있습니다.

지식 및 메모 →

</td> <td width="55%"> <a href="https://useagent.org/docs/concepts/knowledge-and-learning/"> <picture> <source media="(prefers-reduced-motion: reduce)" srcset="docs/media/demo-memory.jpg"> <source srcset="docs/media/demo-memory.gif" type="image/gif"> <img src="https://raw.githubusercontent.com/useagenthq/useagent/HEAD/docs/media/demo-memory.jpg" alt="어두운 테마와 밝은 테마로 표시된, 조직 및 개인 뷰가 분리된 메모 허브입니다." width="100%"> </picture> </a> </td> </tr> </table>

작업 공간 내의 추가 기능:

사용 가능한 파일 - 문서, 스프레드시트, 프레젠테이션, PDF, 이미지 및 비디오를 지원합니다. 지원되는 작업물은 개정된 편집과 네이티브 내보내기를 제공합니다.
Slack에서 작업하기 - 에이전트를 언급하고, 첨부 파일을 보내고, 스레드에서 아티팩트를 받을 수 있습니다.
반복 작업 - 작업을 예약하거나, 기록을 검사하거나, 즉시 실행할 수 있습니다.
승인 제어 - 게이트 도구(gated tools)는 결정을 위해 일시 중지되고, 단발적이고 인자(argument)-제한된 기능으로 재개됩니다.
내구성 세션 - Postgres가 이벤트 타임라인을 저장하며; 복구 시 재시작 후 라이브 세션을 재확인합니다.

지원되는 에이전트

<kbd>Claude Code</kbd>   <kbd>Codex</kbd>   <kbd>OpenCode</kbd>   <kbd>Pi</kbd>

엔진 전반에 걸쳐 단일 세션 UI와 이벤트 형식을 제공합니다. 프로바이더 계정 또는 API 키를 연결하면, 사용 가능한 모델, 로그인 방식 및 도구는 엔진과 구성에 따라 달라집니다. 엔진 가이드를 참조하세요.

통합(Integrations)

표면 (Surface)	연결되는 것 (What's connected)
작업 시작 지점	웹 앱, Slack, 이메일, REST API, CLI 및 MCP, 스케줄. 모든 채널은 동일한 실행 게이트를 통해 진입합니다
...

시작하기

호스팅 방식(Hosted). 위 호스팅 앱 사용을 따르세요.

소스 코드에서(From source). bun과 pgvector가 포함된 Postgres 16+가 필요합니다. Postgres가 준비되어 있지 않나요? 하나의 컨테이너로 해결할 수 있습니다:

git clone https://github.com/useagenthq/useagent.git && cd useagent

docker run -d --name useagent-pg -p 127.0.0.1:5432:5432 \
...

실제 에이전트 작업을 실행하려면 샌드박스 제공자 키와 모델 키가 필요합니다. 설정 가이드에서 두 가지 모두를 안내합니다. bun run typecheck는 모든 패키지를 검사합니다.

자체 호스팅 (Self-hosting)

UseAgent는 모든 Linux 호스트: AWS, Google Cloud, Azure 또는 베어 메탈에서 실행됩니다.
infra/self-host/에 전체 가이드, 원클릭 레퍼런스 호스트(Terraform), 그리고 제공자 독립적인 deploy-app.sh가 있습니다:

SERVER_IP=<호스트-ip> PG_PASSWORD=... OPENROUTER_API_KEY=... \
  infra/self-host/deploy-app.sh /path/to/this/repo

샌드박스는 플러그인입니다: Daytona (관리형, 가장 쉬운 시작), CubeSandbox (완전한 데이터 지역성을 위해 자체 하드웨어에서 실행) 또는 Box. 단일 머신을 위한 Docker Compose는 docs/operations/compose-releases.md에 있습니다.

아키텍처 (Architecture)

세 가지 속성이 핵심적인 역할을 수행합니다:

엔진은 플러그인입니다. 모든 엔진은 어댑터를 통해 하나의 이벤트 형식을 사용하므로, 엔진을 교체해도 스레드, 파일 및 메모리를 유지할 수 있습니다.
모든 실행(run)은 이벤트 로그입니다. Postgres가 진실의 원천(source of truth)입니다: 실행 기록은 백엔드 재시작에도 살아남으며, 정확하게 재생되고 나중에 검사 가능합니다.
자격 증명(Credentials)이 샌드박스에 들어가지 않습니다. 에이전트의 컴퓨터는 격리되어 있습니다. 모든 통합 호출은 타입이 지정된 도구(typed tool)로서 신뢰할 수 있는 게이트웨이를 통과하며, 키는 사용자의 제어 평면(control plane)에 남아 있습니다.

경로	소유하는 것
`frontend/`	제품 UI: 채팅, 세션, 스킬, 플레이북, 위키, 아티팩트, 자동화, 설정
...
더 많은 내용은 문서(documentation) 및 상호 작용하는 요청 흐름 다이어그램에서 확인할 수 있습니다.

Hacktoberfest 2026

UseAgent는 Hacktoberfest에 참여합니다. hacktoberfest 레이블이 붙은 이슈를 선택하고, 자신이 맡는다고 댓글을 남긴 후 풀 리퀘스트(pull request)를 여세요.

처음인가요? good first issue부터 시작하세요.
더 큰 것을 원하나요? 채널 이슈(Discord, Telegram, Microsoft Teams)는 기존 커넥터 프레임워크를 기반으로 하며, 이메일 커넥터가 구현된 예시입니다.
카운트 방식: 병합(merged), 승인(approved) 또는 hacktoberfest-accepted 풀 리퀘스트가 카운트됩니다. 노력이 적은 풀 리퀘스트는 닫힙니다.

첫 풀 리퀘스트를 보내기 전에 CONTRIBUTING.md를 읽어보세요.