@noodlbox/opencode-plugin

Noodlbox plugin for OpenCode - semantic code search and knowledge graph tools.

Installation

$3

``bash
noodl configure
`

This installs the plugin via npm and configures the MCP server automatically.

$3

1. Install the plugin:

`bash
cd ~/.config/opencode
npm install @noodlbox/opencode-plugin
`

2. Add to ~/.config/opencode/opencode.json:

`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

$3

Verify the plugin is installed:
`bash
ls ~/.config/opencode/node_modules/@noodlbox/opencode-plugin
`

$3

1. Check MCP config: cat ~/.config/opencode/opencode.json
2. Verify noodl is in PATH: which noodl
3. Test MCP server: noodl mcp`

Documentation

- Getting Started
- MCP Setup

License

MIT