TL;DR

Coworker는 Electron 기반의 오픈소스 데스크탑 에이전트로서 로컬 우선 아키텍처를 통해 파일 정리, 문서 생성, 브라우저 자동화 같은 반복 작업을 자동화한다; 사용자는 OpenAI·Anthropic 등 외부 API 키를 직접 연결하거나 Ollama 같은 로컬 런타임으로 모델을 구동해 네트워크 전송 없이 추론을 수행할 수 있다. 내부 구조는 UI가 Electron/React로 제공되고 별도의 데몬이 OpenCode 자식 프로세스를 스폰해 작업 실행을 분리 처리하며 API 키는 운영체제 키체인에 저장돼 보안 경계를 유지한다. 다중 플랫폼용 설치 아티팩트와 MIT 라이선스 공개로 커뮤니티 수정과 확장이 용이하며 프라이버시 민감 환경에서 로컬 자동화를 적용하려는 워크플로에 적합하지만 외부 API 또는 로컬 모델 설정과 플랫폼 호환성은 사용자가 사전에 준비해야 하는 전제 조건이다.

주요 기능

• 파일을 자동으로 정리하고 이름을 변경하며 규칙에 따라 이동할 수 있다. 이 기능은 로컬 파일 접근 권한을 기반으로 동작하며 사용자가 접근 허가한 폴더에서만 작업이 수행된다. 작업 전후에 로그와 사용자 승인이 제공되어 안전하게 자동화를 적용할 수 있다.
• 문서를 작성·요약·재작성하는 워크플로를 실행할 수 있다. 프롬프트를 통해 문서 생성 요청을 보내면 내부적으로 선택한 모델이나 API로 텍스트 생성이 이루어지고 결과를 로컬 파일로 저장하거나 클립보드로 복사할 수 있다. 생성 과정에서 사용자가 결과를 검토하고 승인할 수 있는 인터랙션이 마련되어 있다.
• 브라우저 기반 작업을 자동화하여 리서치·폼 입력 같은 반복 작업을 수행할 수 있다. 데몬이 작업을 스폰하고 OpenCode 프로세스와 통신해 브라우저 자동화 스크립트를 실행하도록 설계되어 있다. 모든 브라우저 작업은 사용자 승인 흐름을 통해 제어되며 자동화 기록이 남는다.

어떻게 동작하는가

데스크탑 앱은 Electron과 React(Vite 번들)를 사용해 UI를 제공하고 긴 실행 백그라운드 프로세스(데몬)가 작업 실행을 담당한다. 데몬은 OpenCode의 serve 자식 프로세스를 스폰하고 @opencode-ai/sdk를 통해 이들 프로세스와 통신해 실제 액션을 분리 실행한다. API 키는 운영체제 키체인에 저장되어 로컬에서만 접근되며, Ollama 같은 로컬 런타임을 통해 외부 API 없이도 모델 추론을 수행할 수 있다.

해결 문제

중복적이고 규칙 기반의 파일 정리, 문서 생성 및 브라우저 상 반복 작업이라는 생산성 병목을 로컬에서 자동화해 수동 작업 시간을 줄인다. 프라이버시 우려로 클라우드 전송을 꺼리는 환경에서 사용자가 자신의 파일과 API 키를 제어하면서 AI 기반 자동화를 적용할 수 있게 한다. 또한 로컬 모델 실행과 외부 API 병행 사용을 허용해 유연한 배포 옵션을 제공한다.

지금 주목받는 이유

로컬에서 AI 기반 자동화를 실행하면서 개인 데이터 노출을 최소화하는 로컬 퍼스트 설계와 BYO 모델 전략이 보안·프라이버시 민감 환경에서 주목을 받았다. 오픈소스이자 MIT 라이선스로 누구나 코드를 확인하고 수정할 수 있다는 점이 커뮤니티 확산을 촉진했다. Electron 기반의 데스크탑 배포와 다중 플랫폼 빌드 아티팩트 제공으로 사용 진입 장벽이 낮아진 점도 확산 요인이다.

차별점

• 로컬 우선 아키텍처를 채택해 파일과 키가 기본적으로 사용자 장치에 머물도록 설계되어 있으며 외부 서비스로의 자동 전송이 이루어지지 않는다. 이 구조는 프라이버시 요구가 높은 워크플로에서 데이터를 외부에 노출하지 않는 운영을 가능하게 한다. 사용자는 접근 가능한 폴더 범위를 직접 설정해 권한 경계를 세밀하게 관리할 수 있다.
• BYO(Bring Your Own) 모델·키 전략을 지원해 OpenAI·Anthropic 등 외부 API와 Ollama 같은 로컬 런타임을 모두 연결할 수 있다. 이 방식은 구독 기반 서비스에 종속되지 않고 사용자가 비용과 성능을 직접 선택할 수 있는 유연성을 제공한다. 로컬 모델을 선택하면 네트워크 전송 비용과 외부 의존성을 줄일 수 있다.
• 작업 실행을 데몬으로 분리하고 OpenCode 자식 프로세스로 오프로드하는 설계를 사용해 UI와 실행 환경을 분리했다. 이 분리로 인해 개별 작업의 격리와 로그 관리가 가능하며 데몬 레벨에서 작업 큐와 재시도 로직을 적용할 수 있는 기반이 마련된다. @opencode-ai/sdk를 통한 통신은 확장된 액션 런타임과의 연동을 수월하게 만든다.

사용 사례

• 지저분한 프로젝트 폴더를 파일 유형·메타데이터·날짜 기준 규칙으로 자동 정리하는 용도로 활용할 수 있다. 규칙 실행 전 사용자 승인이 요구되므로 실수로 인한 파일 손실 위험을 낮출 수 있다. 정리 결과는 로그로 남아 이후 감사와 복구 지점을 제공한다.
• 회의록·보고서·주간 업데이트 같은 문서를 프롬프트로 생성하거나 요약해 반복적인 문서 작업 시간을 단축하는 데 사용할 수 있다. 생성된 문서는 로컬에 저장되며 사용자는 편집·승인 후 공유할 수 있다. 외부 API 또는 로컬 모델을 선택해 품질과 비용을 조절할 수 있다.
• 웹 리서치와 폼 입력 자동화 같은 브라우저 기반 반복 작업을 스크립트로 실행해 사람의 수작업을 대체할 수 있다. 데몬이 OpenCode 프로세스를 통해 브라우저 작업을 분리 실행하므로 UI 응답성에 영향이 적다. 모든 자동화는 실행 로그와 사용자 승인 흐름을 통해 추적 가능하다.

시작하기

애플리케이션 설치는 플랫폼별 배포 파일을 다운로드해 설치하면 되며 개발 환경에서는 pnpm으로 의존성을 설치한 뒤 pnpm dev로 로컬 개발 서버를 실행해 앱을 띄울 수 있다. README에 명시된 설치 파일들은 macOS(Apple Silicon/Intel), Windows 11, Ubuntu ARM64/x64용으로 제공되어 플랫폼 선택에 따라 적절한 아티팩트를 다운로드하면 된다. 초기 실행 시 API 키를 연결하거나 Ollama 같은 로컬 런타임을 설정해 모델 연결을 완료하고 접근 허가를 통해 작업 대상 폴더를 지정하면 기본 워크플로를 바로 실행할 수 있다.

요구사항

• 지원 운영체제는 macOS(Apple Silicon), macOS(Intel), Windows 11, Ubuntu ARM64, Ubuntu x64로서 README에 명시된 플랫폼 중 하나를 사용해야 한다. 배포된 설치 파일이 각 플랫폼별로 제공되므로 사용 중인 OS에 맞는 아티팩트를 내려받아 설치하면 된다.
• 개발 목적으로는 Node.js 20 이상과 pnpm 9 이상이 요구되며 pnpm을 통해 의존성을 설치하고 pnpm dev로 개발 모드를 실행할 수 있다. 해당 런타임 사양은 로컬 빌드 및 테스트에 필요한 최소 버전으로 명시되어 있다.