Claude Code Plugin

The noodlbox plugin for Claude Code provides skills, commands, and hooks that enable intelligent codebase exploration and analysis.

Installation

Automatic Setup (Recommended)

The easiest way to install the plugin is through the noodlbox CLI:

noodl configure

This automatically:

• Installs the noodlbox Claude Code plugin
• Configures MCP server connection

If the plugin is already installed, noodl configure --force will update it to the latest version.

Manual Setup

If you prefer manual installation:

claude plugin marketplace add noodlbox/noodlbox-claude-plugins
claude plugin install noodlbox@noodlbox

The plugin auto-updates when you run noodl update.

Plugin Architecture

The plugin provides two types of content:

Commands

Plugin commands use the /noodlbox:command format:

/noodlbox:setup-noodlbox

Set up noodlbox MCP context for the current project.

/noodlbox:setup-noodlbox

This command:

1. Reads the setup:// MCP resource to get noodlbox context
2. Creates or updates CLAUDE.md at the project root with noodlbox configuration

Use this in new projects to give Claude full context about noodlbox tools and resources.

Skills

The plugin includes the noodlbox-setup skill for initializing noodlbox context in a project. It's automatically loaded with the plugin.

CLI Depth Control

The CLI supports depth control for query and search commands:

# Get symbol definitions only (default)
noodl query "authentication flow" --depth definitions

# Get symbols with all relationships
noodl query "error handling" --depth full
noodl search "payments" -d full

Workflow: First-Time Setup

For a new repository:

1. noodl analyze /path/to/repo    # Analyze codebase
2. /noodlbox:setup-noodlbox       # Set up noodlbox context

Workflow: Pre-Commit Review

Before committing changes, use the noodlbox_detect_impact MCP tool:

Use noodlbox_detect_impact to analyze my staged changes

Review impacted processes and plan testing based on impact.

Labels File (Optional)

You can manually create a .noodlbox/labels.json file to provide human-readable names:

{
  "version": "1.0",
  "repository": "owner/my-app",
  "communities": {
    "abc123": {
      "label": "Authentication System",
      "description": "Handles login, token validation, sessions"
    }
  },
  "processes": {
    "proc_001": {
      "label": "User Login Flow",
      "description": "Validates credentials, creates session"
    }
  }
}

Used by:

• noodl CLI commands
• MCP resources (@noodlbox:map://)
• Architecture generation

Updating the Plugin

Automatic Update (Recommended)

The plugin is automatically updated when you update the CLI:

noodl update

Or force update via configure:

noodl configure --force

Manual Update

claude plugin marketplace update noodlbox
claude plugin update noodlbox@noodlbox

Related

• Getting Started - Installation and MCP setup
• Change Analysis - Dependencies and impact workflow
• Code Exploration - Exploration patterns