Skip to content

PLUGINS.md

Latest commit

 

History

History
91 lines (91 loc) · 3.34 KB

PLUGINS.md

File metadata and controls

91 lines (91 loc) · 3.34 KB

Plugins

This document lists the external MCP servers and plugins used by this OpenCode configuration.

Linear

Type: Remote MCP (OAuth) Linear's official MCP server for issue tracking, project management, and team workflows.

  • URL: https://mcp.linear.app/mcp
  • Auth: Run opencode mcp auth linear to complete the browser-based OAuth flow

Verify

opencode mcp list

Fallback: linear-cli (when MCP auth is blocked)

If your workspace blocks Linear MCP authentication or installation, you can still use Linear in OpenCode through local slash commands powered by @dotbrains/linear-cli.

1) Install linear-cli

npm config set @dotbrains:registry https://npm.pkg.github.com
npm config set //npm.pkg.github.com/:_authToken $(gh auth token)
npm install -g @dotbrains/linear-cli

2) Configure credentials

linear init

This creates ~/.config/linear/config.json with your Linear API key.

3) Use the fallback slash commands

Two commands are included in command/:

  • /linear-search <term> → runs linear search "<term>"
  • /linear-issue <id-or-identifier> → runs linear issue "<id-or-identifier>" Example:
/linear-search auth bug
/linear-issue ENG-123

Notion

Type: Remote MCP (OAuth) Notion's official hosted MCP server for reading and writing workspace content.

  • URL: https://mcp.notion.com/mcp
  • Auth: Run opencode mcp auth notion to complete the browser-based OAuth flow

Verify

opencode mcp list

Fallback: notion-cli (when MCP auth is blocked)

If your workspace blocks Notion MCP installation (for example, approved-connections restrictions), you can still use Notion in OpenCode through local slash commands powered by @dotbrains/notion-cli.

1) Install notion-cli

npm config set @dotbrains:registry https://npm.pkg.github.com
npm config set //npm.pkg.github.com/:_authToken $(gh auth token)
npm install -g @dotbrains/notion-cli

2) Configure credentials

notion init

This creates ~/.config/notion/config.json with your Notion credentials.

3) Use the fallback slash commands

Two commands are included in command/:

  • /notion-search <query> → runs notion search "<query>" --json --limit 20
  • /notion-page <page-id> → runs notion page "<page-id>" --json Example:
/notion-search onboarding checklist
/notion-page 01234567-89ab-cdef-0123-456789abcdef

context-mode

Repository: mksglu/context-mode Context Mode is an MCP server that keeps raw tool output out of your context window and tracks session state in SQLite for continuity across compactions.

  • MCP tools: ctx_batch_execute, ctx_execute, ctx_execute_file, ctx_index, ctx_search, ctx_fetch_and_index
  • Plugin hooks: tool.execute.before, tool.execute.after, experimental.session.compacting

Prerequisites

  • Node.js 18+

Install

Install context-mode globally:

npm install -g context-mode

The opencode.json in this repo already registers context-mode as both an MCP server and a plugin. After installing the npm package and cloning this config, restart OpenCode.

Verify

In an OpenCode session, run:

ctx doctor

All checks should pass. You can also run ctx stats to see context savings.

Upgrade

npm update -g context-mode

Or from within OpenCode:

ctx upgrade