## openteams가 뭔가요?
이미 Claude Code, Codex, Gemini CLI 같은 코딩 Agent를 사용하고 있을 것입니다. 각각 따로 쓸 때는 잘 작동합니다. 그러다 두 번째 터미널을 열고, 세 번째 터미널도 엽니다. 같은 컨텍스트를 반복해서 설명하고, 결과를 다른 창으로 옮기고, 누가 무엇을 바꾸는지 직접 기억합니다. 얼마 지나지 않아, 일을 관리하는 대신 Agent를 관리하게 됩니다. 변경 사항은 여러 세션에 흩어져 있고, 프로젝트 우선순위는 다른 곳에 있으며, Token 사용량은 실제로 제공된 결과물과 연결되어 있지 않습니다.
openteams는 기존 에이전트 도구만으로 부족했던 부분을 채웁니다. **에이전트가 대화하고 작업을 넘길 수 있는 하나의 공유 공간, 개발자가 직접 보고 통제하는 계획, 그리고 로드맵을 에이전트에게 넘기지 않으면서 프로젝트 작업과 에이전트 결과물을 연결하는 가벼운 로컬 기록입니다.**
| openteams가 **하는 것** | openteams가 **아닌 것** |
| --- | --- |
| 기존 코딩 Agent를 연결하는 로컬 우선 워크스페이스 | 새로운 모델이나 Claude Code, Codex, Gemini CLI의 대체품 |
| Agent가 대화하고 작업을 넘기며 같은 컨텍스트를 유지하는 공유 세션 | 사용자가 직접 계속 조율해야 하는 여러 개의 독립 채팅 창 |
| 개발자가 관리하고 에이전트 세션에 연결하는 이슈 목록 | 완전한 프로젝트 관리 제품이나 에이전트가 다시 쓰는 로드맵 |
| 단계별로 확인하고 리뷰하고 중단하고 재시도할 수 있는 워크플로 | 끝날 때까지 내부를 볼 수 없는 하나의 큰 프롬프트 |
| 각각 리뷰하고 병합하거나 폐기할 수 있는 격리 worktree | 여러 Agent가 같은 워크스페이스를 수정하며 서로 방해하는 상태 |
| 에이전트의 결과물, 사용량, 비용을 함께 보여 주는 빌드 통계 | 무엇을 만들었는지 알 수 없는 토큰 카운터 |
**설치하면 구체적으로 다음을 사용할 수 있습니다.** 가벼운 협업과 계획된 실행을 위한 채팅 세션, 바로 사용할 수 있는 팀 워크플로 템플릿, 작업을 세션에 연결하면서 개발자가 관리하는 이슈, 병렬 작업을 분리하는 독립 워크스페이스, 그리고 완전한 빌드 통계입니다.
```text
openteams 없음 openteams 사용
Claude ─ terminal A ─┐ Claude ─┐
Codex ── terminal B ─┼─ 직접 중계 Codex ─┼─ 공유 세션
Gemini ─ terminal C ─┘ Gemini ─┘
계획: 다른 곳 이슈 ── 세션 ── 빌드 결과
```
## 왜 openteams인가?
Agent에게 코드를 작성하게 하는 것 자체는 이제 어렵지 않습니다. 어려운 건 그 작업을 제대로 관리하는 일입니다. 컨텍스트가 이어지는지, 지금 어디까지 진행됐는지, 병렬 작업이 서로 덮어쓰지 않는지, 다음에 무엇을 해야 하는지, 그리고 얼마를 썼는지 알아야 합니다.
openteams는 에이전트와 관련 대화를 하나의 세션에 모읍니다. 작업이 복잡하면 Workflow 모드에서 단계와 의존성을 확인할 수 있어, 전부 다시 시작하지 않고 필요한 부분만 검토하거나 재시도할 수 있습니다. 여러 세션을 동시에 실행할 때는 각 세션에 별도의 Git worktree를 사용해 미완성 변경을 분리하고, 나중에 병합할지 폐기할지 결정할 수 있습니다.
프로젝트 방향은 개발자가 정합니다. 이슈에는 개발자가 선택한 작업을 기록하고, 에이전트가 실제로 작업하는 세션을 연결합니다. 에이전트는 일을 수행하지만 계획을 대신 바꾸지는 않습니다. 작업이 끝나면 빌드 통계에서 결과와 토큰 사용량, 비용을 함께 확인할 수 있습니다.
openteams의 목표는 Agent를 더 많이 붙이는 것이 아닙니다. 지금 무엇을 만들고 있는지, 변경은 어디에 있는지, 다음 할 일은 무엇인지, 그 결과에 얼마를 썼는지 언제든 알 수 있게 하는 것입니다.
## 빠른 시작
### 설치
#### 데스크톱 앱(권장)
GitHub Releases에서 사용 중인 플랫폼에 맞는 최신 릴리스를 다운로드하세요.
[](https://github.com/openteams-lab/openteams/releases/latest/download/openteams-windows-x64.msi)
[](https://github.com/openteams-lab/openteams/releases/latest/download/openteams-macos.dmg)
[](https://github.com/openteams-lab/openteams/releases/latest/download/openteams-linux-amd64.deb)
**macOS:** 현재 macOS 릴리스는 Apple Developer ID로 서명되거나 공증되지 않았습니다. 브라우저는 인터넷에서 다운로드한 앱에 격리 속성을 추가하므로 다운로드 파일이 손상되지 않았더라도 Gatekeeper가 openteams를 “손상됨”으로 표시할 수 있습니다. `openteams.app`을 `/Applications`로 옮긴 후, openteams 공식 GitHub Release에서 받은 앱이라고 신뢰할 수 있을 때만 다음 명령을 실행하세요.
```bash
xattr -dr com.apple.quarantine /Applications/openteams.app
```
이 명령은 openteams의 격리 속성만 제거하며 Gatekeeper를 시스템 전체에서 비활성화하지 않습니다.
#### npx
```bash
npx openteams-web
```
### 제공자 설정
**openteams**에는 내장 openteams CLI 에이전트가 포함되어 있습니다. 앱에서 `Settings → Provider Config → Add Provider`로 모델 제공자를 설정하세요.
⚙️ [제공자 설정](https://doc.openteams-lab.com/advanced-usage/custom-provider)
다음과 같은 지원 코딩 에이전트도 연결할 수 있습니다.
| 에이전트 | 설치 예시 |
| --- | --- |
| Claude Code | `npm i -g @anthropic-ai/claude-code` |
| Gemini CLI | `npm i -g @google/gemini-cli` |
| Codex | `npm i -g @openai/codex` |
| Qwen Code | `npm i -g @qwen-code/qwen-code` |
| OpenCode | `npm i -g opencode-ai` |
📚 [더 많은 에이전트 설치 가이드](https://doc.openteams-lab.com/getting-started)
## 주요 업데이트
- **2026.05.20 (v0.4.4)**
- Workflow 모드 beta 버전
- **2026.05.07 (v0.3.22)**
- 그룹 채팅 세션의 멤버를 클릭 한 번으로 프리셋 팀에 저장할 수 있습니다
- **2026.04.14 (v0.3.15)**
- Workspace File Change Viewer
- **2026.04.06 (v0.3.12)**
- 다크 UI 모드 활성화
- openteams-cli 동시성 문제 수정
- **2026.04.02 (v0.3.10)**
- 앱 내 버전 업데이트 구현
- 문서 웹사이트 공개
## 로드맵
openteams는 활발히 개발 중입니다. 앞으로 다음 방향으로 나아갑니다.
- [ ] **전문 AI 작업자** — 전문 분야 지식을 갖추고 전문적인 문제를 해결할 수 있는 AI 작업자를 더 많이 제공합니다.
- [ ] **고성과 AI 팀** — 효율적인 전문 AI 작업자로 팀을 구성해 특정 비즈니스에 맞게 생산 워크플로를 조정하고, 요구사항을 처음부터 끝까지 산출물로 전환합니다.
- [ ] **더 많은 에이전트 통합** — Kilo Code, hermes-agent, openclaw 등 더 많은 범용 에이전트를 통합합니다.
***비전: 토큰 소비를 실제 생산성으로 바꾸기.***
기능 요청이 있거나 방향성에 참여하고 싶다면 [토론을 열어 주세요](https://github.com/openteams-lab/openteams/discussions).
## 커뮤니티
- [GitHub Issues](https://github.com/openteams-lab/openteams/issues): 버그 리포트와 기능 요청
- [GitHub Discussions](https://github.com/openteams-lab/openteams/discussions): 제품 아이디어와 질문
- [Discord](https://discord.gg/openteams): 커뮤니티 채팅
- [Linux.do](https://linux.do): 관련 커뮤니티, 교류를 지원해 주셔서 감사합니다
- 커뮤니티 그룹:
## 핵심 기능
| 기능 | 의미 |
| --- | --- |
| AI 직원과 AI 팀 | 토큰을 실제 생산성으로 바꿉니다. 각 AI 직원 또는 팀은 도메인 전문성을 갖고 범용 모델을 전문가로 끌어올립니다. 단순히 텍스트를 생성하는 데 그치지 않고 실제 산출물을 만들어 냅니다. |
| 멀티 에이전트 워크스페이스 | 여러 AI 에이전트를 하나의 공유 세션으로 모아 별도 창을 오갈 필요를 줄입니다. |
| 공유 컨텍스트 | 에이전트는 같은 대화와 프로젝트 컨텍스트를 기반으로 작업합니다. |
| Free Chat | `@`를 사용해 직접적이고 가벼운 에이전트 협업을 할 수 있습니다. |
| Workflow 모드 | 복잡한 작업을 구조화된 단계, 의존성, 리뷰, 재시도, 승인으로 변환합니다. |
| 보이는 실행 | 각 에이전트가 무엇을 하고 있는지, 어디에서 작업이 막혔는지 볼 수 있습니다. |
| 리뷰와 재시도 | 단계를 리뷰하고 필요한 작업만 다시 시도해 전체 프로젝트 재시작을 피합니다. |
| 이슈 관리 | 개발자가 관리하는 작업 항목을 기록하고 우선순위를 정하며, GitHub 이슈를 동기화하고 실행 세션을 만들거나 연결합니다. |
| 격리 워크스페이스 | 세션별 독립 Git worktree에서 작업한 뒤 다른 작업에 영향을 주지 않고 각 결과를 검토, 병합 또는 폐기합니다. |
| 빌드 통계 | 수정한 버그와 제공한 기능을 세션 및 모델별 토큰 사용량 및 비용과 비교합니다. |
| 아티팩트와 추적 | 로그, diff, 트랜스크립트, 생성된 아티팩트를 작업에 연결해 보관합니다. |
| 로컬 워크스페이스 실행 | 에이전트는 설정된 워크스페이스에서 작업하며 실행 기록은 `.openteams/` 아래에 저장됩니다. |
## 이런 분들에게 적합합니다
openteams는 다음 사용자에게 적합합니다.
- 여러 코딩 에이전트를 사용하면서 전환과 조율에 지친 개발자
- 에이전트 실행을 검토 가능하고 재현 가능하게 관리해야 하는 기술 리드
이것은 단순히 더 많은 에이전트를 모아두는 장소가 아닙니다. 에이전트를 실제로 일하는 팀으로 바꾸는 방법입니다.
## 기술 스택
| 계층 | 기술 |
| --- | --- |
| Frontend | React, TypeScript, Vite, Tailwind CSS |
| Backend | Rust |
| Desktop | Tauri |
| Database | SQLx-managed relational schema |
| Workflow UI | React Flow |
## 로컬 개발
### 필수 조건
- **Rust** >= 1.75
- **Node.js** >= 18
- **pnpm** >= 8
### macOS, Linux, Windows
```bash
# Clone the repository
git clone https://github.com/openteams-lab/openteams.git
cd openteams
pnpm i
npm run dev
# build
pnpm --filter frontend build
pnpm desktop:build
```
### 로컬에서 `openteams-cli` 빌드
내장 또는 공개 빌드 대신 로컬 `openteams-cli` 바이너리를 컴파일해야 한다면 아래 명령을 사용하세요.
빌드 산출물은 binaries 디렉터리에 생성됩니다.
```bash
# From the repository root
bun run ./scripts/build-openteams-cli.ts
```
### Windows 문제 해결(선택 사항)
Windows에서 `pnpm run dev` 실행 시 `error: no such command: watch` 오류가 표시되면 `cargo-watch`를 설치한 후 개발 명령을 다시 실행하세요. 이 오류가 발생한 경우에만 설치하면 됩니다.
```powershell
cargo install cargo-watch
```
## 기여
기여를 환영합니다. 다른 사용자가 배우고 응용할 수 있는 재사용 가능한 AI 팀 워크플로 공유도 환영합니다. 시작 방법은 다음과 같습니다.
1. **이슈 찾기** — 입문자에게 적합한 작업은 [Good First Issues](https://github.com/openteams-lab/openteams/labels/good%20first%20issue)를 확인하거나 열린 이슈를 둘러보세요.
2. **개발 전에 논의하기** — 큰 pull request를 열기 전에 방향을 맞추기 위해 이슈 또는 토론을 열어 주세요.
3. **코드 스타일 따르기** — 제출 전에 아래를 실행하세요.
```bash
pnpm run format
pnpm run check
pnpm run lint
```
4. **PR 제출** — 무엇을 왜 변경했는지 설명하세요. 관련 issue가 있다면 링크해 주세요.
전체 가이드는 [CONTRIBUTING.md](../CONTRIBUTING.md)를 참고하세요.
## 라이선스
openteams는 Apache License 2.0으로 배포됩니다. 쉽게 말해 다음과 같이 사용할 수 있습니다.
- 개인, 교육, 내부 또는 상업 프로젝트에서 무료로 사용합니다.
- 소스 코드를 복사하고 수정해 새로운 작업의 기반으로 사용합니다.
- 원본이나 수정본을 소스 코드 또는 컴파일된 소프트웨어로 배포합니다.
- 비공개 소스 제품에 포함해 판매하면서도 제품의 나머지 코드는 공개하지 않습니다.
openteams 또는 수정본을 재배포할 때는 라이선스 사본을 포함하고, 관련 저작권 및 출처 고지를 유지하며, 변경한 파일을 명확히 표시해야 합니다.
그 밖에 알아둘 점은 세 가지입니다.
- **브랜드:** 코드는 사용할 수 있지만 openteams 공식 프로젝트인 것처럼 표시하거나 openteams 이름과 상표를 자신의 브랜드로 사용할 수는 없습니다.
- **특허:** 코드 기여자는 자신의 코드와 필수적으로 관련된 특허를 근거로 사용자의 openteams 이용을 막지 않겠다고 약속합니다. 대신 “openteams가 내 특허를 침해했다”는 이유로 소송을 제기하면 이 특허 보호를 잃게 됩니다. 종료되는 것은 특허 허가뿐이며 일반적인 코드 사용 권한은 그대로 유지됩니다. 특허 소송을 하지 않는 일반 사용자에게는 사실상 영향이 없습니다.
- **위험:** 소프트웨어는 무료로 현재 상태 그대로 제공됩니다. 자신의 용도에 맞는지와 사용 중 발생하는 문제나 위험은 사용자가 직접 판단하고 책임져야 하며, 프로젝트는 보증이나 손해 배상을 제공하지 않습니다.
이 절은 이해를 돕기 위한 요약입니다. 법적 효력은 [LICENSE](../LICENSE)의 조건을 따릅니다.
전체 법적 조건은 [LICENSE](../LICENSE)를 확인하세요.
