Integrations
Ways to integrate Noodlbox into your AI coding workflow
Noodlbox integrates into your AI coding workflow through multiple channels, from fully automatic context injection to explicit tool calls.
Integration Matrix
| Integration | Type | When it fires | What it does |
|---|---|---|---|
| Session Hooks | Automatic | Conversation start | Injects architecture context |
| Search Hooks | Automatic | Glob/Grep/Bash searches | Adds semantic context to searches |
| MCP Tools | On demand | When invoked | Explicit queries for context, impact, and graphs |
| Skills | Automatic | Based on your question | Guides Claude on which tools to use |
Automatic vs On-Demand
Automatic integrations work without any action from you:
- Session hooks inject context when a conversation begins
- Search hooks enhance search tools with architectural context
- Skills help Claude decide when to use Noodlbox tools
On-demand integrations are invoked explicitly:
- MCP tools for direct queries when you need specific information
- Commands like
/noodlbox:detect_impactfor specific workflows
Getting Started
With the Noodlbox CLI, configuration is automatic:
noodl configureThis sets up your selected agents with:
- MCP server connection
- Skills (intelligent tool selection)
- Hooks (automatic context injection where supported)
For agents not directly supported, see Other Agents for manual MCP configuration.
Platform Support
Noodlbox supports multiple AI coding assistants with platform-specific integrations:
| Platform | Session Hook | Search Hook | Context Injection | MCP Tools |
|---|---|---|---|---|
| Claude Code | ✅ SessionStart | ✅ PreToolUse | ✅ additionalContext | ✅ |
| Cursor | ❌ | ✅ beforeShellExecution | ✅ agent_message | ✅ |
| OpenCode | ✅ session.created | ✅ tool.execute.before | ✅ chat.message | ✅ |
| Codex | ❌ | ❌ | ❌ | ✅ |
| Other Agents | ❌ | ❌ | Manual (AGENTS.md) | ✅ |
Skills Distribution
Skills are centralized in the noodlbox plugins repository and distributed to each platform:
| Platform | Skills Location |
|---|---|
| Claude Code | Bundled with the plugin |
| Cursor | Installed to ~/.cursor/skills/ |
| OpenCode | Installed to ~/.config/opencode/skill/ |
| Codex | Installed to ~/.codex/skills/ |
| Other Agents | Manual setup via setup:// resource |
All platforms receive the same 6 skills:
- Exploring Codebases - Architecture and flow understanding
- Debugging - Bug tracking with graph queries
- Refactoring - Impact analysis for changes
- Change Planning - Pre-commit impact assessment
- Generating Documentation - Architecture map creation
- Setup - Initialize noodlbox context in a project