English | 简体中文 | 한국어

---

Fork & Extension of Oh My OpenCode by @code-yeongyu

This project extends the original with a cross-platform Electron desktop application, featuring a floating AI bubble, quick-action panel, global hotkeys, voice input, theming system, and more.

---

What's New in This Fork

Desktop Application (NEW) Cross-platform — Windows / macOS / Linux Floating AI Bubble — always-on-top quick access Mini Quick-Action Panel — translate, summarize, explain code, fix code Voice Input (ASR/TTS) — Whisper API integration Global Hotkeys — Ctrl+Shift+Space toggle panel Theme System — light/dark/system, 8 accent colors, 5 sidebar colors System Tray — minimize to tray, context menu Built-in Terminal — cross-platform shell Chat History — persistent conversations with search

Extensions & Optimizations i18n Multi-language — 简体中文 / English / 한국어 switchable Electron Desktop Wrapper — native app experience IPC Architecture — secure contextBridge communication OpenCode SDK Integration — direct API connection with streaming Event-driven Streaming — real-time AI response display Settings Sync — shared between main window and bubble Accessibility — proper ARIA attributes, keyboard navigation CSS Architecture — utility classes, Safari compatibility CI/CD Pipeline — GitHub Actions auto-build for all platforms Security Patched — Electron 40.4.1, node-tar fixed

---

Quick Start

Desktop App

cd desktop
npm install
npm start          # Development
npm run build:win  # Build for Windows
npm run build:mac  # Build for macOS
npm run build:linux # Build for Linux

Original Plugin

# Let your AI agent install it:
# "Install oh-my-opencode following: https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md"

---

Downloads

Pre-built binaries are available from GitHub Actions artifacts, or build locally:

Platform	Format	Local Build	CI Build
Windows	NSIS installer + Portable exe	npm run build:win	✅ GitHub Actions
macOS	DMG + ZIP	npm run build:mac	✅ GitHub Actions
Linux	AppImage + DEB	npm run build:linux	✅ GitHub Actions
Quick Test	Unpacked folder	npm run build:dir	—

Tip: Go to Actions → Build & Release → latest run → Artifacts section to download.

---

Multi-Language Support (i18n)

The entire desktop UI supports 3 languages with real-time switching:

Language	Code	Status
简体中文	zh	✅ Default
English	en	✅ Full
한국어	ko	✅ Full

How to switch: Settings → Interface Language → select language → instant apply.

All UI elements are translated: titlebar, sidebar, welcome screen, panels, input area, bubble, context menus, settings modal, and terminal.

---

Desktop App Features

Floating AI Bubble

Action	Function
Single Click	Expand mini quick-action panel
Drag	Move bubble freely (5px threshold)
Right Click	Context menu (panel / main window / settings / quit)
Esc	Close current overlay

Global Shortcuts

Shortcut	Action
Ctrl+Shift+O	Toggle main window
Ctrl+Shift+B	Toggle bubble visibility
Ctrl+Shift+Space	Toggle mini quick-action panel
Ctrl+Shift+Q	Quit application

Quick Actions

Button	Function
Translate	Translate selected text
Summarize	Summarize content
Explain Code	Explain code snippets
Fix Code	Fix code issues
Voice	Voice input via Whisper ASR

CI/CD — GitHub Actions

All platforms are built automatically via GitHub Actions:

# Trigger: push tags (v*) or manual workflow_dispatch
# Builds: Windows (NSIS+Portable), macOS (DMG+ZIP), Linux (AppImage+DEB)
# Artifacts uploaded per platform for download

To release a new version:

git tag v1.0.1
git push --tags   # Triggers auto-build for Win/Mac/Linux

Or trigger manually: Actions → Build & Release → Run workflow

---

Project Structure

oh-my-opencode-dev/
├── src/                    # Original plugin source (TypeScript)
├── desktop/                # NEW: Electron desktop application
│   ├── main.js             # Main process (IPC, shortcuts, OpenCode SDK)
│   ├── preload.js          # Secure IPC bridge
│   ├── package.json        # Desktop dependencies + build config
│   └── renderer/
│       ├── index.html      # Main window UI
│       ├── styles.css      # Theming system
│       ├── app.js          # Application logic
│       ├── i18n.js         # Internationalization (zh/en/ko)
│       └── bubble.html     # Floating bubble + mini panel
├── .github/workflows/      # CI/CD (GitHub Actions)
├── docs/                   # Documentation
├── packages/               # Platform binaries
├── bin/                    # CLI entry point
└── README.md               # This file

---

Original Plugin Features

All original features from Oh My OpenCode are preserved.

Click to expand full feature list

• Agents: Sisyphus (main), Prometheus (planner), Oracle (debugging), Librarian (docs), Explore (grep), Hephaestus (deep worker)
• Background Agents: Run multiple agents in parallel
• LSP & AST Tools: Refactoring, rename, diagnostics
• Context Injection: Auto-inject AGENTS.md, README.md
• Claude Code Compatibility: Full hook system, commands, skills, MCPs
• Built-in MCPs: websearch (Exa), context7 (docs), grep_app (GitHub search)
• Session Tools: History, search, analysis
• Productivity: Ralph Loop, Todo Enforcer, Comment Checker, Think Mode
• Configuration: JSONC support, per-agent overrides, categories, hooks

See the original Features Documentation and Configuration Documentation.

---

Acknowledgments

Original Project Oh My OpenCode by @code-yeongyu The best AI agent harness — batteries-included OpenCode plugin with multi-model orchestration, parallel background agents, and crafted LSP/AST tools. This fork would not exist without the incredible foundation built by the original author.

OpenCode OpenCode by @sst The open-source AI coding platform that makes all of this possible.

Special Thanks

• @code-yeongyu — Original oh-my-opencode creator, for the revolutionary agent harness design
• @junhoyeo — For the amazing hero image in the original project
• @sst — For building and maintaining OpenCode
• The open-source community — For continuous feedback and contributions

---

Security

All known vulnerabilities have been patched:

Package	Issue	Fix
electron	ASAR Integrity Bypass (Moderate)	Upgraded to 40.4.1
node-tar	Path Traversal, Symlink Poisoning, Race Condition (3× High)	Upgraded via electron-builder@26.7.0

npm audit → 0 vulnerabilities

---

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

1. Fork this repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

License

This project inherits the SUL-1.0 License from the original Oh My OpenCode project.

---

Built with passion by @sjkncs

Standing on the shoulders of giants