TL;DR

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

핵심 포인트

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