@constellationdev/opencode

v1.4.0工具与命令

@constellationdev/opencode

Upgrade OpenCode from text search to code understanding.

维护活跃

#opencode #opencode-plugin #constellation #code-intelligence #code-analysis #dependency-analysis

GitHub 仓库 npm 页面官方主页

GitHub 星标

月装机量

近 7 天 2

综合评分SCORE

16.7

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@constellationdev/opencode@1.4.0"]
}

写入 ~/.config/opencode/opencode.json，对所有项目生效。

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@constellationdev/opencode@1.4.0"]
}

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

查看原始文件→

A lightweight OpenCode plugin that wires up the Constellation MCP server and steers OpenCode toward code_intel for code search and navigation.

What it does

Capability	How
Registers the Constellation MCP server	`config` hook spawns `npx -y @constellationdev/mcp@latest` and forwards `CONSTELLATION_ACCESS_KEY`
Prefers `code_intel` over text search	`experimental.chat.system.transform` appends a single instruction to the system prompt
Survives context compaction	`experimental.session.compacting` re-pushes the `code_intel` preference into the compacted summary

The plugin ships no skills, no agents, and no slash commands. It is purely an integration layer — once installed, the Constellation MCP server's code_intel tool is available to OpenCode and its subagents.

Installation

Prerequisites

A Constellation account with a project indexed
CONSTELLATION_ACCESS_KEY exported in your environment (must start with ak:)

Setup

Add the plugin to your project's opencode.json:

{
  "plugin": ["@constellationdev/opencode"]
}

OpenCode installs the plugin at startup. No further configuration is required — the MCP server is registered programmatically by the config hook.

Install at the project level, not globally. The plugin should only be enabled in projects indexed by Constellation.

Behavior

The plugin always registers the MCP server. The system-prompt and compaction hooks only attach when CONSTELLATION_ACCESS_KEY starts with ak:. Without a valid key, the MCP server still spawns and surfaces its own auth error to the user.

Privacy: Constellation extracts structural code metadata locally and uploads only that metadata, your source is never transmitted.

Troubleshooting

Issue	Resolution
`AUTH_ERROR` from Constellation	Verify `CONSTELLATION_ACCESS_KEY` is exported and starts with `ak:`. Use `constellation auth` to set it.
`PROJECT_NOT_INDEXED`	Run `constellation index --full` in the project root.
`code_intel` tool missing in OpenCode	Confirm the plugin is listed in `opencode.json`, restart OpenCode, and check that `npx @constellationdev/mcp@latest` resolves.

Development

npm install
npm run type-check
npm run build      # tsc → dist/

Releases are published from GitHub Releases — see .github/workflows/publish.yml.

See AGENTS.md for plugin internals and contributor guidance.

Documentation

License

GNU Affero General Public License v3.0 (AGPL-3.0)