Nuru means "light" in Swahili - illuminating the path to your commands with clarity and simplicity.

dotnet add package TimeWarp.Nuru

using TimeWarp.Nuru;

var builder = NuruApp.CreateBuilder(args);
builder.Map("add {x:double} {y:double}", (double x, double y) =>
  Console.WriteLine($"{x} + {y} = {x + y}"));
return await builder.Build().RunAsync(args);

using TimeWarp.Nuru;

NuruApp app = new NuruAppBuilder()
  .Map("add {x:double} {y:double}", (double x, double y) =>
    Console.WriteLine($"{x} + {y} = {x + y}"))
  .Build();

return await app.RunAsync(args);

dotnet run -- add 15 25
# Output: 15 + 25 = 40

→ Full Getting Started Guide

• Getting Started Guide - Build your first CLI app in 5 minutes
• Use Cases - Greenfield apps & progressive enhancement patterns
• Architecture Choices - Choose Direct, Mediator, or Mixed

• Routing Patterns - Complete route syntax reference
• Roslyn Analyzer - Compile-time validation
• Logging System - Structured logging setup
• Auto-Help - Automatic help generation
• Output Handling - stdout/stderr best practices

• MCP Server - AI-powered development assistance
• Deployment Guide - Native AOT, runfiles, distribution
• Best Practices - Patterns for maintainable CLIs

• Performance Benchmarks - Detailed performance metrics
• Supported Types - Complete type reference
• API Documentation - Technical reference

Build modern command-line tools from scratch:

NuruApp app = new NuruAppBuilder()
  .Map
  (
    "deploy {env} --version {tag?}",
    (string env, string? tag) => Deploy(env, tag)
  )
  .Map
  (
    "backup {source} {dest?} --compress",
    (string source, string? dest, bool compress) => Backup(source, dest, compress)
  )
  .Build();

Wrap existing CLIs to add auth, logging, or validation:

NuruApp app = new NuruAppBuilder()
  .Map
  (
    "deploy prod",
    async () =>
    {
      if (!await ValidateAccess()) return 1;
      return await Shell.ExecuteAsync("existing-cli", "deploy", "prod");
    }
  )
  .Map
  (
    "{*args}",
    async (string[] args) => await Shell.ExecuteAsync("existing-cli", args)
  )
  .Build();

→ Detailed Use Cases with Examples

Calculator Samples - Four complete implementations you can run now:

• calc-createbuilder.cs - ASP.NET Core-style API (recommended)
• calc-delegate.cs - Direct approach (pure performance)
• calc-mediator.cs - Mediator pattern (enterprise)
• calc-mixed.cs - Mixed approach (classic builder)

./Samples/Calculator/calc-mixed.cs add 10 20        # Direct: fast
./Samples/Calculator/calc-mixed.cs factorial 5      # Mediator: structured

Cocona Comparison - Migration guides from Cocona

Native AOT is 88-93% faster than JIT → Full Performance Benchmarks

Install the MCP server for AI assistance:

dotnet tool install --global TimeWarp.Nuru.Mcp

Get instant help in Claude Code, Roo Code, or Continue:

• Validate route patterns before writing code
• Generate handler code automatically
• Get syntax examples on demand
• Real-time error guidance

→ MCP Server Setup Guide

Enable tab completion for your CLI with one line of code:

NuruApp app = new NuruAppBuilder()
  .Map("deploy {env} --version {tag}", (string env, string tag) => Deploy(env, tag))
  .Map("status", () => ShowStatus())
  .EnableStaticCompletion()  // ← Add this
  .Build();

Generate completion scripts for your shell:

# Bash
./myapp --generate-completion bash >> ~/.bashrc

# Zsh
./myapp --generate-completion zsh >> ~/.zshrc

# PowerShell
./myapp --generate-completion powershell >> $PROFILE

# Fish
./myapp --generate-completion fish > ~/.config/fish/completions/myapp.fish

Supports:

• ✅ Command completion (deploy, status)
• ✅ Option completion (--version, --force)
• ✅ Short option aliases (-v, -f)
• ✅ All 4 major shells (bash, zsh, PowerShell, fish)

See ShellCompletionExample for a complete working example.

We welcome contributions! See CONTRIBUTING.md for details.

For Contributors:

• Developer Documentation - Architecture and design
• Standards - Coding conventions

This project is licensed under the Unlicense - see the LICENSE file for details.