@noodlbox/opencode-plugin
v1.1.1
Published
Noodlbox plugin for OpenCode - semantic code search and knowledge graph tools
Maintainers
Readme
@noodlbox/opencode-plugin
Noodlbox plugin for OpenCode - semantic code search and knowledge graph tools.
Installation
Using noodl configure (Recommended)
noodl configureThis installs the plugin via npm and configures the MCP server automatically.
Manual Installation
- Install the plugin:
cd ~/.config/opencode
npm install @noodlbox/opencode-plugin- Add to
~/.config/opencode/opencode.json:
{
"plugin": ["@noodlbox/opencode-plugin"],
"mcp": {
"noodlbox": {
"type": "local",
"command": ["noodl", "mcp"]
}
}
}Plugin Tools
The plugin provides these tools (via CLI):
| Tool | Description |
|------|-------------|
| noodlbox_search | Semantic search through the knowledge graph |
| noodlbox_query | Execute Cypher queries on the graph |
| noodlbox_repos | List indexed repositories |
| noodlbox_analyze | Index a repository |
| noodlbox_delete | Delete an indexed repository |
MCP Server Tools
The MCP server provides additional tools (via noodl mcp):
| Tool | Description |
|------|-------------|
| noodlbox_noodlbox_query_with_context | Natural language search with context |
| noodlbox_noodlbox_detect_impact | Analyze blast radius of git changes |
| noodlbox_noodlbox_raw_cypher_query | Direct graph queries |
| noodlbox_noodlbox_analyze | Index a repository |
MCP Resources
The MCP server exposes these resources:
| Resource | Description |
|----------|-------------|
| repository://list | List available repositories |
| map://{repo} | Architecture map for a repository |
| setup:// | Setup instructions (AGENTS.md content) |
| db://schema/{repo} | Database schema for a repository |
Environment Variables
NOODLBOX_CLI_PATH: Override the noodl CLI path (default:noodl)
Troubleshooting
Plugin Not Loading
Verify the plugin is installed:
ls ~/.config/opencode/node_modules/@noodlbox/opencode-pluginMCP Tools Not Available
- Check MCP config:
cat ~/.config/opencode/opencode.json - Verify noodl is in PATH:
which noodl - Test MCP server:
noodl mcp
Documentation
License
MIT
