TL;DR

OpenCode Manager는 모바일 우선 PWA 방식의 웹 인터페이스로 OpenCode 에이전트와 다중 리포지토를 한 곳에서 관리하도록 설계된 애플리케이션이다. 서버는 Bun + Hono와 SQLite로 경량화되어 SSE 스트리밍, 스케줄링, 푸시 알림을 제공하고 프론트엔드는 React·Vite 기반 PWA로 모바일과 데스크탑에서 일관된 UX를 유지한다. ocm CLI를 통해 로컬 클론을 Manager에 연결해 고속 git 번들 동기화가 가능하며 Docker Compose로 즉시 배포할 수 있다. 이 구조는 원격 에이전트 운영과 모바일에서의 빠른 확인·수정 워크플로를 단순화하지만 MCP 서버 설정, OAuth 및 API 키 구성 같은 초기 인증·구성 단계가 필요하다는 한계가 존재한다.

주요 기능

• 리포지토리와 Git을 통합해 다중 리포지토 검색, SSH 인증, worktree 관리, 브랜치·커밋·통합 diff 조작을 지원한다. 이 기능은 로컬 저장소 탐지와 원격 조작을 동일 UI에서 수행하도록 설계됐다. 작업 내역과 브랜치 상태를 한 눈에 파악할 수 있게 상태 아이콘과 타임스탬프를 제공한다.
• 실시간 채팅과 세션 기능에서 SSE 스트리밍을 사용해 모델 응답을 점진적으로 수신하고 slash 명령과 @file 멘션을 통해 컨텍스트를 주입할 수 있다. Plan/Build 모드와 Mermaid 다이어그램 렌더링을 통해 대화형 설계와 단계별 실행 흐름을 관리할 수 있다. 세션은 재사용 가능한 스케줄과 연계되어 자동화된 작업 실행 이력을 유지한다.
• 파일 브라우저는 트리 뷰, 문법 하이라이팅, 생성·이름 변경·삭제 기능과 ZIP 다운로드를 제공해 코드와 리소스를 직접 편집·배포할 수 있다. 파일 변경은 에이전트 작업과 연계되어 @file 참조로 세션 컨텍스트에 포함될 수 있다. 브라우저 기반 편집은 모바일 환경에서도 사용성을 유지하도록 최적화됐다.
• Assistant Mode는 에이전트 전용 작업공간을 제공하며 스킬 정의를 자동 프로비저닝해 일정, 알림, 설정, 리포 관리 같은 기능을 에이전트에 할당한다. 스킬은 범위가 지정된 공유 가능한 단위로 구성되어 재사용과 팀 협업을 지원한다. 알림과 푸시 이벤트는 세션 상태 변화와 에러, 완료 이벤트를 사용자에게 전달한다.
• MCP 서버 관리와 AI 구성 화면을 통해 로컬 또는 원격 MCP 서버를 추가·인증하고 모델 제공자 API 키와 OAuth 연결을 중앙에서 설정할 수 있다. ocm CLI를 통해 로컬 TUI를 Manager에 연결하고 Git 기반의 고속 동기화(pull/push)를 수행할 수 있다. 이 통합은 에이전트 실행 환경과 파일시스템 접근을 Manager가 중개하도록 구성한다.

어떻게 동작하는가

레포지토리는 shared, backend, frontend의 pnpm 워크스페이스로 구성돼 각 패키지가 타입·스키마·유틸리티를 공유한다. 백엔드는 Bun과 Hono 기반 API 서버로 OpenCode 프로세스 관리, SQLite 마이그레이션, SSE, 스케줄, 푸시 알림을 제공하며 프론트엔드는 React·Vite·TanStack Query와 서비스 워커로 PWA를 구현해 모바일 우선 UI를 제공한다. ocm CLI는 Manager의 /api/opencode-proxy에 연결해 로컬 클론의 작업트리를 Manager 파일시스템에서 실행되는 OpenCode 서버와 동기화하는 방식으로 작동한다.

해결 문제

원격 또는 모바일 기기에서 OpenCode 에이전트와 저장소를 관리하는 운영 공백을 메꾸고 있다. 사용자는 브라우저 기반 UI로 여러 리포지토와 브랜치, 파일을 한 곳에서 탐색하고 세션·스케줄을 통해 에이전트 작업을 자동화할 수 있다. 또한 ocm CLI와 Docker 배포를 통해 로컬 개발 환경과 운영 Manager 인스턴스 간 동기화를 단순화하고 초기 설치 진입 장벽을 낮췄다.

지금 주목받는 이유

모바일 우선 PWA 인터페이스와 Docker 즉시 배포 조합, 그리고 670개의 스타가 존재하는 공개 관심도 덕분에 주목받고 있다.

차별점

• 모바일 우선 PWA 설계로 데스크탑과 모바일 화면에서 동일한 워크플로를 유지하도록 최적화돼 있다. UI는 설치 가능한 PWA 특성을 포함해 iOS와 Android에서도 네이티브 앱 유사 경험을 제공한다. 이는 기존 대부분의 데스크탑 중심 에이전트 관리 툴과 차별화되는 점이다.
• 백엔드에 Bun + Hono와 SQLite 조합을 사용해 경량화된 API 서버와 빠른 개발 사이클을 확보했다. SSE 기반 실시간 스트리밍과 푸시 알림으로 세션 반응성과 사용자 알림 전달을 구현해 실시간 상호작용을 강화했다. 이러한 아키텍처는 소규모 리소스 환경에서도 동시 접속성과 상태 업데이트를 효율적으로 처리한다.
• ocm CLI는 Manager의 /api/opencode-proxy를 통해 로컬 작업트리를 Manager 파일시스템에서 실행되는 OpenCode 인스턴스와 연결하고 빠른 git 번들 기반 동기화를 제공한다. 이 방식은 복잡한 원격 파일 동기화 대신 중앙 Manager를 통한 안전한 실행 환경 공유를 가능하게 한다. 결과적으로 로컬 TUI와 중앙화된 에이전트 실행을 투명하게 연결한다.
• 깊은 Git 통합으로 worktree 지원, SSH 인증, 통합 diff와 브랜치·커밋 조작을 브라우저에서 직접 제공해 코드 변경 흐름을 단축시킨다. 여러 리포지토를 한 화면에서 관리하면서 즉시 작업 상태와 변경 내역을 확인할 수 있도록 UI 요소들이 설계됐다. 이는 별도 데스크탑 Git 클라이언트를 띄우지 않고도 많은 운영 작업을 수행하게 한다.
• Docker Compose를 통한 원클릭 배포 경로를 제공해 로컬이나 서버 환경에 빠르게 배포할 수 있도록 설계됐다. README의 Quick Start는 환경변수 기반 비밀키 생성과 docker-compose up 동작으로 첫 실행을 간소화한다. 이 배포 옵션은 즉시 프로덕션 수준이 아닌 테스트·시범 운영에 적합하도록 맞추어져 있다.

사용 사례

• 휴대폰이나 태블릿으로 원격 리포지토리의 코드와 에이전트 세션을 점검하고 간단한 수정이나 커밋을 수행하는 용도로 활용할 수 있다. 이 방식은 현장 점검이나 빠른 패치 적용이 필요할 때 데스크탑을 켜지 않아도 작업 흐름을 이어가게 한다. 세션과 알림 연동으로 작업 완료와 오류를 즉시 인지할 수 있다.
• 정기 스케줄을 이용해 반복 작업이나 자동화된 프롬프트 실행을 예약하고 결과 히스토리를 보존하는 자동화 파이프라인 관리를 수행할 수 있다. 스케줄마다 재사용 가능한 프롬프트를 연결하고 마크다운 렌더링 결과를 기록해 감사와 재현성을 확보한다. 이 기능은 정기 리포트 생성이나 주기적 코드·문서 검토 자동화에 유용하다.
• 로컬 개발자는 ocm CLI를 통해 로컬 TUI를 Manager에 연결하고 Manager에서 제공하는 에이전트 환경을 활용해 테스트를 수행한 뒤 변경사항을 빠르게 동기화할 수 있다. 이 워크플로는 여러 개발자가 동일 Manager 인스턴스의 파일시스템과 에이전트 실행을 공유할 때 유용하다. Git 번들 기반의 고속 동기화는 대용량 변경에도 효율적이다.

시작하기

Quick Start는 저장소를 클론한 뒤 .env 예시를 복사하고 AUTH_SECRET을 생성한 뒤 docker-compose로 서비스를 기동하는 방식으로 시작된다. 예시 명령은 git clone 후 cp .env.example .env, AUTH_SECRET 생성 커맨드와 docker-compose up -d를 포함해 첫 실행 후 http://localhost:5003로 접속하면 관리자 계정 생성 화면이 표시된다. 로컬 개발을 원하면 pnpm install 후 pnpm dev로 개발 서버를 실행하고 lint와 typecheck, test를 통해 코드 품질을 확인할 수 있다.

요구사항

• 백엔드 실행을 위해 Bun 런타임과 Hono 프레임워크에 대한 의존성이 존재하며 SQLite를 데이터 저장소로 사용한다. 프론트엔드 개발은 React와 Vite, TanStack Query, Tailwind 및 Radix UI를 전제로 하며 서비스 워커로 PWA 기능을 제공한다. 개발 환경에서는 pnpm을 사용한 워크스페이스 관리와 Docker Compose가 로컬 또는 서버 배포에 요구된다.

이미지 분석