<div align="center">
<img src="https://raw.githubusercontent.com/jeffreycayao/Dev-Labs/HEAD/docs/images/devlabs-logo.png" alt="DevLabs" width="128">
DevLabs™
사용자의 기기에서 실행되는 AI 코딩 에이전트의 오피스
무료이며 오픈 소스이고 로컬 우선(local-first)입니다. 사용자가 이미 비용을 지불하고 있는 AI 구독 서비스와 연동되는 멀티 에이전트 하네스입니다. 이는 사용자가 이미 실행하고 있는 터미널 코딩 CLI를 팀으로 만듭니다. 각 에이전트는 책상, 터미널, 메모리, 받은 편지함을 갖게 되며, Ramon이라는 오케스트레이터가 사용자가 자리를 비운 동안 작업 흐름을 유지합니다.
사용자 자체 키(bring-your-own keys)와 로컬 모델을 사용하여 Claude Code, OpenAI Codex, Antigravity 및 Gemini CLI, xAI Grok, Kimi Code, Qwen, OpenCode, Crush, pi, GitHub Copilot CLI 및 Cursor를 래핑합니다. 필리핀 에디션으로, Pancake POS와 Webcake용 커넥터를 포함합니다.
<p>
<em>Electron · React · TypeScript · Three.js (React Three Fiber) · xterm.js · node-pty</em>
</p>
<p>
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-C7FD11.svg?style=flat-square&labelColor=0B0A06"></a>
<a href="./CHANGELOG.md"><img alt="Version: 4.2.1" src="https://img.shields.io/badge/version-4.2.1-C7FD11.svg?style=flat-square&labelColor=0B0A06"></a>
<img alt="Platform: macOS | Windows | Linux" src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-F4F1EA.svg?style=flat-square&labelColor=0B0A06">
<img alt="No account needed" src="https://img.shields.io/badge/account-not%20needed-F4F1EA.svg?style=flat-square&labelColor=0B0A06">
<a href="./CONTRIBUTING.md"><img alt="PRs welcome" src="https://img.shields.io/badge/PRs-welcome-C7FD11.svg?style=flat-square&labelColor=0B0A06"></a>
<a href="https://devlabs.atmt.dev"><img alt="Website: devlabs.atmt.dev" src="https://img.shields.io/badge/web-devlabs.atmt.dev-CDF252.svg?style=flat-square&labelColor=181C17"></a>
</p>
⬇ macOS, Windows 또는 Linux용 다운로드
계정 필요 없음, 로그인 불필요, 라이선스 키도 없습니다. 모든 설치 프로그램은 릴리스 페이지에 있습니다.
처음이신가요? 사용자 가이드부터 시작하세요.
Chaitanya Giri가 만든 Munder Difflin의 포크(fork) 버전이며, 동일한 MIT 라이선스 하에 배포되었습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/jeffreycayao/Dev-Labs/HEAD/docs/images/devlabs-office.gif" alt="The DevLabs 3D office: agents walking to their desks, chatting at the coffee machine and working" width="900">
</p>
<p align="center">
<img src="https://raw.githubusercontent.com/jeffreycayao/Dev-Labs/HEAD/docs/images/devlabs-app.png" alt="The full DevLabs window: the office on the left, an agent's terminal and controls on the right, the team's cards along the bottom" width="900">
</p>
5분 만에 사용하기 (코딩 필요 없음)
- 좋아하는 AI 도구를 설치하고 로그인하세요. Claude Code가 가장 쉽게 시작할 수 있는 방법입니다. DevLabs는 사용자의 자체 AI 계정을 사용하며, AI를 판매하지 않습니다.
- devlabs.atmt.dev에서 DevLabs를 다운로드하여 실행하세요.
- 빠른 설정 질문 4가지에 답변하세요. 제시된 답변으로도 충분합니다. 에이전트가 무언가를 변경하기 전에 사용자에게 확인하도록 하려면 **먼저 문의(ask first)**를 선택하세요.
- Ramon(빨간색 명찰을 단 매니저)을 클릭하고 원하는 것을 일반적인 언어로 입력하세요. 예를 들어 "제 베이커리를 위한 한 페이지 웹사이트를 HTML 파일로 만들어줘"와 같이요.
- 사무실을 지켜보세요. 에이전트가 책상으로 걸어가 작업을 시작합니다. 작업이 완료되면 파일이 Ramon의 납품(deliveries) 탭에 나타납니다. 승인하거나 변경을 요청할 수 있습니다.
그 외 모든 내용은 **일반 언어 사용자 가이드**에 나와 있습니다.
[!] 참고
당신의 에이전트들, 하나의 사무실, 그리고 한 명의 매니저.
DevLabs는 사용자가 이미 실행하고 있는 터미널 기반 에이전트 CLI(예: claude, codex, agy, gemini, grok, kimi, qwen, opencode, crush, pi, copilot 및 cursor-agent)를 가져와 스스로 조정하는 팀으로 변환합니다. 각 에이전트는 장기 메모리(long-term memory), 사서함(mailbox), 그리고 3D 사무실의 책상을 갖게 되며, Ramon이 헤드 데스크에서 작업을 계획하고 당신이 지켜보는 동안 이를 배분합니다. 그가 사무실을 운영하지만, 여전히 당신이 그를 운영합니다.
목차 (Contents)
지원되는 에이전트 (Supported agents)
이미 비용을 지불하고 사용하는 CLI를 가져오세요. 이 목록의 모든 도구는 사용자의 기존 구독 및 제한 내에서 자체 터미널에 실제 프로세스로 실행됩니다. 터미널에서 실행될 수 있다면, 여기서도 실행할 수 있습니다.
<p>
<a href="https://docs.claude.com/en/docs/claude-code"><kbd>Claude Code</kbd></a>
<a href="https://github.com/openai/codex"><kbd>Codex · GPT</kbd></a>
<a href="https://antigravity.google/docs/cli-overview"><kbd>Antigravity · Gemini</kbd></a>
<a href="https://github.com/google-gemini/gemini-cli"><kbd>Gemini CLI</kbd></a>
<a href="https://x.ai/cli"><kbd>Grok · xAI</kbd></a>
<a href="https://www.kimi.com/code"><kbd>Kimi Code</kbd></a>
<a href="https://github.com/QwenLM/qwen-code"><kbd>Qwen</kbd></a>
<a href="https://opencode.ai/docs"><kbd>OpenCode</kbd></a>
<a href="https://github.com/charmbracelet/crush"><kbd>Crush · Charm</kbd></a>
<a href="https://pi.dev/docs/latest"><kbd>Pi</kbd></a>
<a href="https://docs.github.com/copilot/concepts/agents/about-copilot-cli"><kbd>GitHub Copilot</kbd></a>
<a href="https://cursor.com/docs/cli/install"><kbd>Cursor</kbd></a>
<kbd>+ 기타 사용자 지정 명령어</kbd>
</p>
OpenCode, Crush 또는 pi를 통해 연결되는 모든 모델(GLM (Z.ai Coding Plan), DeepSeek, Ollama를 통한 로컬 모델 등)을 추가할 수 있습니다.
개요
DevLabs는 실제 터미널 에이전트 CLI를 완전히 기능하는 에이전트로 감싸고, 이를 공유 파일의 허브(hive)에 연결하며, 오케스트레이터인 Ramon을 담당하게 하는 데스크톱 앱입니다. Ramon은 작업을 수행하도록 지시받는 유일한 에이전트입니다.
- 모든 터미널은 에이전트입니다. 각
claude, codex, agy, grok, opencode 또는 사용자 지정 세션은 가상 터미널(node-pty)에서 실제 프로세스로 실행되며, xterm.js로 렌더링됩니다.
- 모든 에이전트는 아바타입니다. 세션은 필리핀 국기, Ramon의 상사 사무실, 그리고 피뇨이(Pinoy) 오피스 가십과 함께 3D 사무실(Three.js) 속 캐릭터로 나타납니다.
- 허브가 이를 조정합니다. 에이전트는 자신의 메모리를 읽고 사서함(mailbox)을 비우며, 라우터는 받은 편지함(inbox) 사이로 메시지를 이동시킵니다. Ramon은 사용자에게 필요한 것만 할당하고, 판정하며, 에스컬레이션합니다.
- 지속되는 메모리입니다. 에이전트별 마크다운(Markdown) 메모리가 공유되고 검색 가능한 저장소에 채굴되어, 에이전트들이 세션 간에도 기억할 수 있게 합니다.
작동 방식
you ── talk to ──► ┌─────────────┐
│ Ramon │ orchestrator at the head desk
│ (god agent) │ roster · routing · adjudication
...
- 에이전트 고용하기: 각 에이전트는 자체 작업 폴더, 신원 및 엔진을 가진 일반 터미널 프로세스입니다.
- 허브를 통한 에이전트 협업: 평문 파일로 구성된 로컬 git 저장소입니다. 그들은 자신의
outbox/에 작성하고, 라우터가 수신자의 inbox/로 전달합니다. 오직 하네스(harness)만이 커밋하므로, 에이전트들이 git 잠금(lock)을 두고 다투지 않습니다.
- Ramon의 관리: 그는 모든 요청을 읽고, 일상적인 것은 스스로 처리하며, 중요한 것(지출, 파괴적 작업, 범위 변경 등)만 사용자에게 에스컬레이션합니다.
- 모든 것이 가시적입니다: 현장을 관찰하고, 어떤 터미널이든 실시간으로 읽고, 다시 입력하며, 그 파일과 git 기록을 탐색할 수 있습니다.
멀티 에이전트 디자인은 HIVE.md를, 터미널 및 이벤트 플레인은 SPEC.md를, 시각 시스템은 DESIGN.md를 참고하세요.
기능 (Features)
<table>
<tr
><td width="50%" valign="top">
열두 명이 아닌 한 에이전트와 대화하기
Ramon만이 당신이 브리핑하는 유일한 에이전트입니다. 그는 작업을 계획하고, 적절한 에이전트에게 전달하며, 그들 사이의 트래픽을 라우팅하고, 실제로 당신의 도움이 필요한 몇 가지 사항만 에스컬레이션합니다. Talk 기능을 켜서 음성으로 브리핑할 수 있습니다.
</td>
<td width="50%" valign="top">
전체 팀을 하나의 파일로 고용하기
**층(floor)**은 하나의 .floor.json 파일 또는 atmtlabs://floor 링크로 가져오거나 내보낼 수 있는 에이전트 팀입니다. 준비된 **온라인 판매자 팀(Online Seller Team)**을 사용해 보세요: 상점 관리자, 랜딩 페이지 디자이너, 제품 카피라이터가 포함됩니다. FLOORS.md를 참조하세요.
</td>
</tr>
<tr
><td width="50%" valign="top">
몇 번의 클릭으로 에이전트 한 명 고용하기
엔진, 모델, 자율성을 선택하고 책상을 제공하면 작동을 시작합니다. 단일 에이전트를 고용(hire) 매니페스트 또는 링크로 공유할 수 있습니다. 가져오기만 하면 양식에 채워지고, 여전히 시작 버튼을 누르기만 하면 됩니다. docs/hires를 참조하세요.
</td>
<td width="50%" valign="top">
에이전트가 당신의 상점에서 작업하도록 하기
**연결(Connections)**을 사용하면 에이전트가 Pancake POS (주문, 제품, 재고, 판매), Webcake (랜딩 페이지), GitHub 등 내부에서 작업할 수 있습니다. 키는 컴퓨터에 암호화된 상태로 유지되며, 호스팅되는 커넥터의 경우 에이전트는 절대 키를 볼 수 없습니다. CONNECTORS.md를 참조하세요.
</td>
</tr>
<tr
><td width="50%" valign="top">
하나의 층만이 아닌 전체 건물
다른 리포지토리(repo)나 폴더를 위해 새 층을 열 수 있으며, 각 층은 자체 에이전트, 작업 및 메모리를 가지며, 최대 200개 층까지 한 번에 가능합니다. Ramon이 건물을 관리하며, 서로 다른 층의 에이전트는 메시지를 주고받을 수 있습니다.
</td>
<td width="50%" valign="top">
목줄이 달린 자율성
</td>
</tr>
</table>
각 에이전트가 스스로 어느 정도까지 진행할 수 있는지 설정합니다. 에이전트별 및 층별 토큰 예산(Token budgets), 지출 및 파괴적 작업에 대한 승인, 그리고 루프를 돌거나 통제 불능 상태로 실행되는 것을 안내하고 제한한 다음 중지시키는 회로 차단기 기능이 있습니다.
<table>
<tr>
<td width="50%" valign="top">
### 완성된 파일은 사용자에게 돌아옵니다
에이전트는 완료된 작업물(HTML, Markdown, PDF, DOCX, 이미지, 스프레드시트, 슬라이드)을 **산출물(Deliveries)** 형태로 반환합니다. Command Center 트레이에서 검토하고 원하는 곳에 저장하세요.
</td>
<td width="50%" valign="top">
### 한 번 설정하기
온보딩 마법사(onboarding wizard)가 사용자가 이미 가지고 있는 것을 확인하고 누락된 항목을 설치할지 제안합니다. 누락된 CLI는 에이전트의 터미널에서 오류 대신 **설치(Install)** 카드로 표시됩니다.
</td>
</tr>
</table>
층 (The floor)
- 모든 터미널은 실제 에이전트입니다. 12개의 엔진 또는 사용자 지정 명령어가 각각 자체 PTY에 배치되며 xterm.js로 렌더링됩니다.
- 모든 에이전트는 아바타입니다. 책상, 주방, 체육관, QA 연구실, 서버실, 그리고 Ramon을 위한 BOSS 사무실이 있는 3D 오피스 공간의 아바타가 됩니다.
- 추가 및 삭제할 수 있는 오피스 층입니다. 오피스 층당 최대 15개의 에이전트를 배치할 수 있습니다. + 층 추가를 누르면 새 층이 열리고, − 층 삭제를 누르면 빈 층이 제거됩니다 (상위 층들은 아래로 이동하며 레이아웃을 유지합니다).
- 에이전트별 git worktree입니다. 병렬 에이전트들이 브랜치에서 충돌하는 것을 방지하기 위한 선택적 격리 기능이며, 기본 체크아웃의
node_modules가 연결됩니다.
- 새 프로젝트 층입니다. 설정(Settings) → 일반(General)을 열면 기존 레포지토리 또는 폴더를 위한 깨끗한 층이 열립니다.
- 백업과 함께 초기화합니다. 해당 층의 에이전트, 작업 및 메모리를 지울 수 있으며, 복원 가능한 ZIP 파일 옵션도 제공됩니다.
- 탑승할 수 있는 건물입니다. 층들은 상태 표시등이 켜진 창문처럼 쌓여있는 건물 같으며; 하나를 클릭하면 엘리베이터가 그곳으로 이동시킵니다. 부드러운 확대 및 패닝(zoom and pan) 기능이 있으며, 무언가가 움직일 때만 장면이 다시 그려집니다.
- 오피스 테마입니다. 레이아웃을 하나의
.office-theme.json 파일로 내보내거나, 다른 파일을 가져올 수 있습니다 (엄격한 스키마에 따라 검사되며 미리보기, 백업 및 되돌리기 기능 제공). 또는 사용자의 AI가 직접 디자인하도록 할 수도 있습니다.
메모리 및 조정(Memory and coordination)
- 더 하이브(The hive): 에이전트별 메모리, 원자 파일 사서함(atomic-file mailboxes), 공유 보드, 추가 전용 이벤트 로그 및 단일 커미터 Git.
- 모든 에이전트를 아우르는 공유 메모리 검색 기능과 사용자의 문서에 대한 지식 그래프(knowledge graph).
- 재시작 및 계속하기(Restart & Continue): 대화 내용을 잃지 않고 깨진 터미널을 다시 그립니다.
- 에이전트 브라우저(Agent Browser): 에이전트가 실제 헤드리스 Chrome(Vercel의 agent-browser)을 구동하여 웹사이트를 열고, 읽고, 사용하며, 각 사이트는 자체 세션에서 작동합니다. 기본적으로 활성화되어 있으며, 스위치 하나로 끌 수 있습니다.
- 에이전시 에이전트의 268가지 준비된 페르소나와 프리랜서 역할(클라이언트 관계, 제안서, 계약, 청구서 발행, 포트폴리오) 및 여섯 가지 DevLabs 기술(3D 게임, Three.js, Anime.js, UI/UX, DevOps, 보안 연구).
- ATTITUDE.md: 에이전트가 사용자에게 어떻게 말해야 하는지 한 번 작성하면 모든 새로운 에이전트가 이를 따릅니다.
