OpenCode Mobile
opencode의 오픈소스 안드로이드 클라이언트로서 AI 코딩 에이전트를 지원합니다.
AI 도움을 받는 코딩 기능 - Android용이며, Google Play, F-Droid 또는 직접적인 APK를 통해 이용할 수 있습니다.
License: MIT
F-Droid repo
Download APK
Google Play
opencode와 제휴하지 않았습니다. OpenCode Mobile은 독립적인 커뮤니티 기반 클라이언트이며, opencode / Anomaly 팀에 의해 제작되거나 보증되거나 관련되지 않습니다. 이 앱은 사용자가 직접 운영하는 opencode 서버에 접속하며, opencode의 오픈 HTTP API를 사용합니다.
새로운 기능: 앱에서 "데모 사용(Try a Demo)"을 누르면 에이전트가 실제 버그를 수정하는 과정(추론(reasoning), grep 검색, diff 비교, 권한 요청 프롬프트 등)을 서버 없이 약 30초 만에 보여줍니다.
설치 방법 (Android)
오늘날 OpenCode Mobile을 설치할 수 있는 세 가지 작동하는 방법이 있으며, 모두 Android용입니다:
-
Google Play — https://play.google.com/store/apps/details?id=cc.agentlabs.opencode
-
F-Droid (자체 호스팅 레포) — 저희 자체 호스팅 레포를 모든 F-Droid 클라이언트에 추가한 다음, 거기서 설치/업데이트합니다:
https://dzianisv.github.io/opencode-mobile/fdroid/repo
F-Droid 앱에서: **설정(Settings) → 레포지토리(Repositories) → + (추가)**를 누르고 위의 URL을 붙여넣습니다. 현재 버전은 v0.4.7입니다.
-
직접 서명된 APK — 최신 릴리스를 다운로드하여 수동으로 설치합니다:
https://github.com/dzianisv/opencode-mobile/releases/latest
iOS는 지원하지 않습니다(로드맵 참조). IzzyOnDroid 제출은 대기 중입니다.
OpenCode Mobile은 opencode AI 코딩 에이전트의 강력한 기능을 휴대폰으로 가져온 React Native / Expo 앱입니다. 로컬 네트워크, Cloudflare Tunnel, ngrok 또는 Tailscale을 통해 자체 호스팅(self-hosted)된 opencode 서버에 연결하여 어디서든 코드 작성, 검토 및 배포를 할 수 있습니다. 모바일 클라이언트는 MIT 라이선스 하에 무료이며 오픈 소스입니다. 기능 제한(feature gate)도 없고, 옵트인하지 않은 원격 측정(telemetry) 데이터도 없으며, 광고 네트워크도 없습니다.
<p align="center">
<img src="https://raw.githubusercontent.com/dzianisv/opencode-mobile/HEAD/distribution/demo.gif" width="240" alt="OpenCode Mobile 데모 — 서버에 연결하고, 세션을 탐색하며, AI 에이전트가 응답을 스트리밍하는 것을 확인하세요" />
</p>
<sub>실제 기기 온디바이스 캡처: 연결 추가, 세션 탐색 및 에이전트의 응답 스트림 시청. 라이브 opencode 서버(빌드 cc.agentlabs.opencode)를 대상으로 안드로이드 에뮬레이터에서 엔드투엔드 검증됨.</sub>
주요 기능 (Features)
- 오프라인 데모 모드 (Offline demo mode) — 설정 없이도 빈 화면 상태에서 전체 버그 수정 과정을 확인하려면 "데모 사용(Try a Demo)"을 탭하세요 (추론 → grep → diff → 권한 프롬프트).
- 다중 연결 (Multi-connection) — 여러 opencode 서버(로컬 네트워크, Cloudflare Tunnel, ngrok 또는 Tailscale)를 관리할 수 있습니다.
- 생체 인식 잠금 해제 (Biometric unlock) — Face ID, Touch ID 또는 안드로이드 지문 인식이 앱과 개별 메시지 전송을 보호합니다.
- 스트리밍 채팅 (Streaming chat) — opencode 서버에서 토큰 단위로 응답 스트림을 직접 받습니다.
- Diff 뷰어 (Diff viewer) — 에이전트가 수행하는 모든 파일 변경 사항에 대한 인라인(inline) 측면 비교(side-by-side diffs)를 제공합니다.
- 도구 호출 승인 (Tool call approval) — 에이전트가 도구를 실행하기 전에 도구 호출을 검토하고 승인하거나 거부할 수 있습니다.
- 보안 자격 증명 저장소 (Secure credential storage) — 서버 자격 증명이
expo-secure-store를 통해 Android Keystore에 저장됩니다.
- 세션 관리 (Session management) — 코딩 세션을 탐색하고, 생성하며, 재개할 수 있습니다.
OpenCode Mobile 받기 (Get OpenCode Mobile)
패키지: cc.agentlabs.opencode · 안드로이드 전용 · 현재 버전 v0.4.7
현재 활성화되고 지원되는 설치 채널은 Google Play, F-Droid 자체 호스팅 리포지토리(self-hosted repo), 그리고 직접 서명된 APK(direct signed APK) 세 가지이며 모두 Android용입니다. IzzyOnDroid는 대기 중이며 iOS 빌드는 없습니다.
빠른 시작 (Quick Start)
아직 서버가 없으신가요? 앱을 설치한 후, '세션(Sessions)' 화면에서 **데모 사용해 보기(Try a Demo)**를 탭하면 됩니다. 별도의 설정이 필요 없습니다. 이 기능을 통해 앱의 실제 채팅, diff, 권한 승인 UI를 사용하여 오프라인 상태에서 약 30초 만에 스크립트된 버그 수정 세션을 재생할 수 있습니다.
1단계 — 로컬 기기에서 opencode 시작하기
npm install -g opencode-ai
...
2단계 — OpenCode Mobile 설치는 Google Play, F-Droid 또는 직접 APK를 통해 진행하거나(또는 소스에서 빌드하여 CONTRIBUTING.md 참조), 모바일 앱을 설치합니다.
3단계 — 앱에 연결 추가하기
앱을 열고 **연결 추가(Add Connection)**를 탭한 후, 원하는 연결 유형을 선택합니다:
- 로컬 네트워크 (Local network) — 기기의 LAN IP 주소. 예:
http://192.168.1.100:4096
- 터널 (Tunnel) — Cloudflare Tunnel 또는 ngrok URL. 예:
https://my-opencode.trycloudflare.com
- Tailscale — 기기의 Tailscale IP 주소. 예:
http://100.x.x.x:4096
- opencode Cloud (계획 중 — 아직 출시되지 않음) — 서버를 실행할 필요가 없는 원탭 관리형 호스팅.
1단계에서 설정한 비밀번호를 입력하고 **연결(Connect)**을 탭하면 사용 준비가 완료됩니다.
작동 방식 (How It Works)
OpenCode Mobile은 경량 클라이언트(thin client)입니다. 이는 opencode HTTP + SSE API를 사용하여 세션 목록 조회, 메시지 전송, 응답 스트리밍, 파일 변경 이벤트 구독 등의 기능을 수행합니다. 모든 AI 모델 호출은 사용자의 opencode 서버에서 처리됩니다. 사용자 본인이 API 키(OpenAI, Anthropic 등)를 가져와야 하며, 앱은 이 키에 절대 접근하지 않습니다. 또한, 앱은 코드나 대화 내용을 당사 서버를 통해 프록시(proxy) 하지 않습니다.
┌─────────────────────────────────────┐
│ OpenCode Mobile │
│ (React Native / Expo, 이 저장소 참조) │
...
프로젝트 상태 (Project Status)
현재 버전: v0.4.7
| 기능 | 상태 |
|---|
| 오프라인 데모 모드 (Offline demo mode) | 안정적 (Stable) |
| ... | |
OpenCode Mobile은 VIBE TECHNOLOGIES, LLC에서 구축하고 유지 관리합니다. GitHub Sponsors는 Sentry, EAS Build, 그리고 CI(지속적 통합) 비용(~월 $60)을 충당하는 데 도움을 줍니다. opencode Cloud 호스팅 백엔드 (계획 중, 월 $10)가 장기적인 수익 모델입니다.
OpenCode Mobile이 시간을 절약해 준다면 스폰서십을 고려해 주세요:
github.com/sponsors/VibeTechnologies
| 등급 (Tier) | 가격 (Price) | 혜택 (Perk) |
|---|
| Supporter | 월 $5 | SUPPORTERS.md에 이름 기재 |
| ... | | |
| 문의 또는 개인 지원: [email protected] | | |
로드맵 (Roadmap)
GitHub Projects 보드와 open 마일스톤(milestones)에서 추적할 수 있습니다.
단기 우선순위:
- opencode Cloud 원터치 연결 + 관리형 호스팅 (managed hosting)
- F-Droid 메인라인 승인 (FCM 감사 + 재현 가능한 빌드 검증)
- 터널 설정 마법사 (Cloudflare / ngrok / Tailscale)
- iPad / 태블릿 레이아웃
- 오프라인 세션 기록 캐시
기여하기 (Contributing)
버그 보고, 기능 요청, 풀 리퀘스트(pull requests)를 환영합니다. 개발 환경 설정 방법과 기여 프로세스는 CONTRIBUTING.md를 참조하세요.
개인정보 보호 (Privacy)
OpenCode Mobile은 개인 데이터를 수집하지 않습니다. 선택적 Sentry 충돌 보고(opt-in, 기본값 비활성화)는 익명화된 충돌 추적(crash traces)을 Sentry로 전송합니다. 분석 SDK(analytics SDKs)는 포함되어 있지 않습니다. 자격 증명(Credentials)은 오직 기기 내 OS 키스토어에 저장됩니다.
전체 개인정보 보호 정책: dzianisv.github.io/opencode-mobile/privacy
라이선스 (License)
MIT — [LICENSE] 참조.
Copyright (c) 2026 VIBE TECHNOLOGIES, LLC
감사의 글
- sst/opencode — 이 앱이 연결되는 AI 코딩 에이전트입니다 (MIT).
- Expo — 앱을 구동하는 React Native 툴체인입니다.
- 버그를 신고하거나, PR(Pull Request)을 열거나, 저장소에 별표 표시를 한 모든 기여자
