Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Opencode Cli

БесплатноНе проверен

Wraps opencode CLI's HTTP API into MCP tools for agent run, session management, and server status, plus a fleet webapp dashboard.

GitHubEmbed

Описание

Wraps opencode CLI's HTTP API into MCP tools for agent run, session management, and server status, plus a fleet webapp dashboard.

README

Just Ruff Python FastMCP

📖 Installation Guide - quick start, manual setup, and troubleshooting 📖 Onboarding - 5-minute first-run guide 📖 Full reference - tools, endpoints, env vars, architecture

MCP server wrapping opencode CLI's HTTP API (opencode serve) into 22 FastMCP tools (7 primary portmanteaus + 15 legacy aliases). Also includes a FastAPI REST bridge (unified with the MCP endpoint on one port), a Vite/React fleet-standard dashboard, and OpenCode custom tools that extend opencode itself.

Pattern: Plan with Claude, implement with opencode. Claude (expensive, high-judgment) orchestrates and supervises; opencode handles implementation grunt work on cheaper models (DeepSeek V4 Flash/Pro).

🧠 Eternal Session Memory — opencode stores every session since install in one searchable SQLite database. Ask it "what were we discussing last December about X?" — no other agentic IDE can do that. opencode-cli-mcp makes that memory searchable, exportable, editable, and backed up.

What can you do?

Capability How
Wayback session find opencode_depot(action="search", query="...") — full-text (FTS5) across every session transcript and title, ever. "What were we working on in December?"
Semantic recall (RAG) opencode_depot(action="rag", query="...") — embeddings-based similarity over indexed transcripts; find it when you don't remember the words. rag_index builds the index, rag_status shows state
Read the past opencode_sessions(action="messages"|"diff"|"export", session_id=...) — full transcript, file changes, or a clean markdown/html document
Edit the past rename / archive / unarchive / delete sessions (live API or offline depot)
Never lose it opencode_backups(action="create"|"restore", ...) — db + config snapshots, rotation, disk guard, autobackup every 24h
Run agents opencode_runs(action="start"|"status"|"list"|"cancel", ...) — launch, supervise, review
Manage opencode opencode_system(...) — status, providers, project, MCP pulse, config drift
Desktop sidebar sidebar/opencode-sidebar.ahk (AHK v2 companion, outside the .mcpb) — docked session list, palette jump, right-click rename/archive/delete, hover previews. See docs/SIDEBAR.md

Install

Download: opencode-cli-mcp-0.2.11-setup.exe - installs the desktop app and its embedded backend in one step (Windows, current user, no admin).

The installer is unsigned, so SmartScreen will warn. Click More info → Run anyway.

All releases, older versions, and the .mcpb bundle: Releases.

You want Use
Desktop app + backend opencode-cli-mcp-0.2.11-setup.exe above
MCP server inside Claude Desktop only opencode-cli-mcp-0.2.11.mcpb from Releases
Manual setup, prerequisites, troubleshooting INSTALL.md
Development setup and build recipes docs/DEVELOPMENT.md

Every path needs the opencode CLI installed (npm i -g opencode-ai).

MCP Tools

Primary surface - seven portmanteaus (operation discriminator):

Tool Purpose
opencode_runs(action=...) start / status / list / cancel agent runs
opencode_sessions(action=...) list / get / messages / send / diff / grep / export / rename / delete sessions (live opencode serve API - the opencode UI picks the changes up immediately)
opencode_depot(action=...) eternal memory - list/archive/unarchive/rename/delete/search/stats over the opencode SQLite DB. Full-text search across EVERY session since install, works offline (no opencode serve needed).
opencode_backups(action=...) protect the memory - db + config snapshots (consistent online backup API), rotation, disk-space guard, guarded restore (refuses while serve runs unless force=True)
opencode_system(action=...) status / providers / project / launch_ui / mcp_pulse / config_drift
opencode_mcpb_install(...) install .mcpb bundles into opencode config
opencode_shutdown(confirm=...) graceful self-termination

15 legacy atomic tools remain mounted as aliases through 0.2.x (opencode_run_agent, opencode_get_run_status, opencode_list_runs, opencode_cancel_run, opencode_list_sessions, opencode_get_session, opencode_send_message, opencode_get_messages, opencode_session_diff, opencode_server_status, opencode_list_providers, opencode_get_project, opencode_get_config, opencode_get_health, opencode_launch_ui, plus opencode_session_grep / opencode_export_session / opencode_config_drift / opencode_mcp_pulse).

Prefab in-chat cards: show_runs_app, show_sessions_app, show_status_app.

Eternal Session Memory

opencode records every conversation and agent run since install into one searchable SQLite database (~/.local/share/opencode/opencode.db). No other agentic IDE has this — you cannot ask Claude or Cursor "what were we discussing last December about santiclaus-mcp?", but you can ask opencode:

opencode_depot(action="search", query="santiclaus")          # wayback find - full-text across ALL transcripts
opencode_depot(action="rag", query="santiclaus")             # semantic recall - embeddings over indexed transcripts
opencode_depot(action="rag_index")                           # build the RAG index (once)
opencode_sessions(action="get", session_id="ses_...")        # metadata
opencode_sessions(action="messages", session_id="ses_...")   # the transcript
opencode_sessions(action="export", session_id="ses_...")     # markdown/html document
opencode_backups(action="create", kind="all")                # protect it (autobackup 24h)

Full walkthrough: docs/ETERNAL_MEMORY.md (also on the webapp Help page and History page).

Key Workflows

See Usage Guide for full details.

Basic: Launch -> Poll -> Review

opencode_run_agent(prompt="refactor main.py", wait=false)
    -> { job_id: "abc" }
opencode_get_run_status("abc")     -> poll until completed
opencode_session_diff("session-xyz") -> review changes

Multi-Agent Sweep

Launch N agents across N repos in parallel, poll all, review diffs. Designed for fleet-wide operations.

Interactive Supervision

Start an agent, read its messages mid-task, send corrections, review final diff.

OpenCode Custom Tools

Copy .opencode/tools/*.ts into your opencode project to give opencode's LLM direct access to MCP fleet management, session inspection, and system diagnostics. 6 tools covering fleet, sessions, runs, system, providers, and tool discovery. See the OC Tools page in the webapp for full documentation and source.

Documentation

Doc Description
Onboarding 5-minute first-run guide
Usage Guide All tools, workflows, async patterns, webapp pages
Integration Guide MCP client config (Claude Desktop, Cursor, Windsurf)
Advanced Usage Async patterns, session management, cross-project, custom tools
Improvement Plan Known issues and roadmap
Changelog Version history

Stack

  • Backend: Python 3.12+, FastMCP 3.4.4, FastAPI, uvicorn, httpx, pydantic v2, prefab-ui, psutil, SQLite (job store)
  • Frontend: React 18, Vite 5, TypeScript, TailwindCSS 3.4, Zustand, Framer Motion, Lucide, React Router, @tauri-apps/api
  • Native: Tauri 2 (NSIS installer, embedded PyInstaller backend)
  • Quality: ruff, biome, pytest (+coverage), Playwright e2e, pre-commit, just

Ports

Port Service
10950 Frontend (Vite)
10951 Backend (FastAPI)
4097 opencode serve (dedicated; desktop app owns 4096)

Security

This MCP server runs arbitrary shell commands (opencode run) from LLM prompts. Only install in environments where you trust your MCP client (Claude Desktop, Cursor) and the models it uses.

Fleet

  • Registered in mcp-central-docs: ports 10950/10951
  • fleet-registry.json and glama.json in repo root
  • Webapp dashboard: http://localhost:10950 (run .\start.ps1)

from github.com/sandraschi/opencode-cli-mcp

Установить Opencode Cli в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE
unyly install opencode-cli-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add opencode-cli-mcp -- uvx --from git+https://github.com/sandraschi/opencode-cli-mcp opencode-cli-mcp

Пошаговые гайды: как установить Opencode Cli

FAQ

Opencode Cli MCP бесплатный?

Да, Opencode Cli MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Opencode Cli?

Нет, Opencode Cli работает без API-ключей и переменных окружения.

Opencode Cli — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Opencode Cli в Claude Desktop, Claude Code или Cursor?

Открой Opencode Cli на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
80

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Opencode Cli with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai