OpenCode Island

A macOS menu bar app for OpenCode CLI sessions with Dynamic Island-style notifications.
Multi-provider LLM support • MCP integration • Memory monitoring

Based on Claude Island by @farouqaldori
Adapted to support OpenCode's multi-provider capabilities with 75+ LLM providers.

Current Phase: Planning Complete
Next Phase: Phase 1 - MVP OpenCode Integration (2-3 weeks)

See Implementation Backlog for detailed roadmap.

• OpenCode Integration — Full support for OpenCode CLI sessions
• Multi-Provider Support — Use Anthropic, OpenAI, Google, DeepSeek, local models, and 75+ providers
• Notch UI — Beautiful animated overlay from the MacBook notch
• Live Session Monitoring — Track multiple OpenCode sessions in real-time
• Permission Approvals — Approve tool executions directly from the notch
• Chat History — View conversation history with markdown rendering

• Provider-Aware UI — See which LLM provider and model you're using
• MCP Server Management — Configure and monitor Model Context Protocol servers
• Enhanced Tool Display — Support for all 18 OpenCode built-in tools
• Configuration UI — Manage OpenCode configuration from settings

• Memory Monitoring — Track OpenCode process memory with alerts
• Auto-Updates — Automatic update checking and installation
• OpenSkills Integration — Support for OpenCode skills (optional)
• Performance Optimizations — Enhanced performance for long-running sessions

• Universal Binary — Single app for Intel and Apple Silicon
• Signed & Notarized — Fully notarized for easy installation
• Comprehensive Testing — Tested across macOS versions and providers
• Complete Documentation — User guide, FAQ, and troubleshooting

• macOS 12.0+ (Intel or Apple Silicon)
• OpenCode CLI (install via npm, Bun, or other package managers)

Note: OpenCode Island is currently in development. Installation instructions will be provided when Phase 1 is complete.

The app will:

1. Install automatically via DMG
2. Set up OpenCode hooks in ~/.config/opencode/hooks/
3. Monitor OpenCode sessions via Unix socket communication

• ✅ 75+ LLM Providers instead of Claude-only
• ✅ MCP Server Coordination with multiple servers
• ✅ Memory Monitoring for process health
• ✅ Provider-Aware UI showing which model you're using
• ✅ Auto-Updates via Sparkle
• ✅ Same great Dynamic Island UI

• ✅ Visual Feedback in menu bar without switching windows
• ✅ Quick Approvals for tool permissions from notch
• ✅ Session Management view all active sessions at a glance
• ✅ Conversation History with markdown rendering
• ✅ Memory Monitoring catch performance issues early

• User Guide - How to use OpenCode Island
• FAQ - Common questions and answers
• Troubleshooting - Solve common issues

• Implementation Backlog - Phased implementation plan
• AGENTS.md - Context for AI coding agents
• OpenCode Documentation - Comprehensive OpenCode guides
• Migration Strategy - Migration from Claude to OpenCode
• Upstream Sync Guide - How to sync with Claude Island

• OpenCode vs Claude Code - Feature comparison
• OpenCode SDK Fundamentals - Learn OpenCode basics
• MCP Architecture - Understanding MCP
• Configuration Guide - OpenCode configuration

Total estimated time: 7-10 weeks

See backlog/SUMMARY.md for detailed roadmap overview.

OpenCode Island is under active development. Contributions are welcome!

Current Focus: Phase 1 MVP implementation

See CONTRIBUTING.md (coming soon) for guidelines.

OpenCode Island is a fork of Claude Island by @farouqaldori.

The original Claude Island provides the excellent Dynamic Island UI and session monitoring architecture that OpenCode Island builds upon.

OpenCode by SST is the open-source AI coding agent that powers OpenCode Island.

• awesome-opencode - Curated OpenCode resources
• Model Context Protocol - MCP specification and servers

Apache 2.0 - See LICENSE.md

• OpenCode Island: GitHub Repository
• Upstream (Claude Island): GitHub Repository
• OpenCode SDK: GitHub Repository | Documentation
• MCP: Website | Servers