Home

Welcome to the nmbl documentation! This guide will help you understand the tool’s capabilities and get you up and running quickly.

What is nmbl?#

nmbl is a developer CLI tool designed to help .NET developers analyze, manage, and maintain their solutions and projects. It provides a comprehensive suite of commands for code analysis, dependency visualization, and project maintenance.

Quick Start#

# Install nmbl (see Getting Started for details)
dotnet tool install --global nmbl

# Authenticate
nmbl login

# Analyze cyclomatic complexity
nmbl cc MySolution.slnx

# Generate dependency graph
nmbl deps MyProject.csproj --output graph.svg

# View all available commands
nmbl help --with-examples

Sections#

• Getting Started - Install nmbl and authenticate
• Commands - Complete command reference
• Authentication - OAuth and license key setup

Key Features#

• Code Analysis - Measure cyclomatic complexity, cognitive complexity, and lines of code
• Dependency Visualization - Generate Mermaid diagrams and SVG graphs of project dependencies
• Project Management - Analyze project references and solution structure
• Code Quality - Count regions, TODO comments, and track technical debt
• Git Operations - Batch update multiple repositories, check repository status
• Maintenance - Clean build artifacts, remove region directives

Command Categories#

Code Analysis Commands (Read-Only)#

File/System Modification Commands#

Authentication Commands#

Technology Stack#

• .NET 10 - Built with the latest .NET
• Roslyn - C# code analysis using Microsoft.CodeAnalysis
• Mermaid - Dependency graph visualization
• Microsoft.Msagl - SVG graph rendering
• TimeWarp.Nuru - CLI framework for command routing