OpenCode Manager

English | 中文文档

---

A universal OpenCode management toolkit for AI Coding Agents.

It provides a unified CLI interface that allows AI agents like Cursor, Claude Code, and Codex cli to easily manage local OpenCode instances.

✨ Core Features

• 🚀 Background Service Management: Start OpenCode servers silently in the background without blocking the current terminal session.
• 🔍 Smart Monitoring: Automatically discover, list, and monitor all running OpenCode processes and their port status.
• 📡 Universal Command Execution: Send tasks via CLI or REST API, supporting any Agent capable of executing Shell commands.
• 📊 Real-time Data Streaming: Supports SSE (Server-Sent Events) to capture execution logs and results in real-time.
• 🧹 Process Cleanup: One-click cleanup of zombie processes to keep your environment tidy.

---

📥 Installation Guide

We offer multiple installation methods, with the remote one-line install being recommended.

⚡️ Remote / YOLO Install (Recommended)

No need to download the repository, just run one of these in your terminal:

# YOLO: one-liner with no options
curl -fsSL https://raw.githubusercontent.com/CXL-edu/opencode-manager-skills/master/install.sh | bash

# Chinese installer UI
curl -fsSL https://raw.githubusercontent.com/CXL-edu/opencode-manager-skills/master/install.sh | bash -s -- --lang zh

# English installer UI
curl -fsSL https://raw.githubusercontent.com/CXL-edu/opencode-manager-skills/master/install.sh | bash -s -- --lang en

1. Install the opencode-manager skill (SKILL.md + references) into your skills directory.
2. It does not install the OpenCode CLI; make sure opencode is available in your PATH.

📦 Quick Install (Local Script)

If you have already cloned this repository, you can use the local script:

# Interactive mode (Recommended)
bash install.sh

# Silent install (English UI)
bash install.sh --lang en

🛠 Manual Install (Git Clone)

If you need full control, you can configure it manually:

1. Clone the repository:

   git clone https://github.com/CXL-edu/opencode-manager-skills.git
   cd opencode-manager-skills

2. Ensure OpenCode CLI: Make sure opencode is installed and available in your system PATH.

3. Configure Agent Skill (e.g., for Cursor):

   • Copy the opencode-manager/ folder to your project's .cursor/skills/ directory.
   • You can then use it in Cursor chat: "Use opencode-manager to start a server..."

Supported skill roots:

• Project-level: .cursor/skills/, .claude/skills/, .codex/skills/
• User-level: ~/.cursor/skills/, ~/.claude/skills/, ~/.codex/skills/

---

🤖 Usage Guide

This toolkit is designed to be Agent Agnostic. As long as your AI coding assistant (Agent) has the ability to execute Shell commands, it can use this tool directly.

Once installed, you don't need to memorize complex CLI arguments. Just give instructions in natural language, and the Agent will automatically translate them into the corresponding opencode-manager commands.

Interaction Examples:

"Start a background OpenCode server on port 4096"

"Check if there are any running OpenCode instances"

"Clean up all unused OpenCode processes"

The Agent will parse your intent and call the underlying opencode-manager tool to complete the task.

---

📂 Directory Structure

opencode-manager/
├── README.md                 # English Documentation (Project Home)
├── docs/
│   └── zh/
│       └── README.md         # Chinese Documentation
├── install.sh                # Unified Installation Script
└── opencode-manager/
    ├── SKILL.md              # Skill entry (required)
    └── references/
        ├── REFERENCE.en.md   # English reference
        └── REFERENCE.zh.md   # Chinese reference

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔖 Version

v2.0 | 2026-01-28 | Compatible with OpenCode 1.1.39+

🔗 Links

• OpenCode GitHub Repository
• OpenCode Official Website
• OpenCode Documentation
• OpenCode Server Docs
• This Project Repository