cli-search

name	cli-search
description	Search for CLI commands and tools installed on your system. Use when you need to find specific functionality, discover available commands, or explore what CLI tools are available.

nuru - CLI Search Tool

Search and discover commands across Nuru-based CLI applications installed on your system.

Package: TimeWarp.Nuru.Search Repository: https://github.com/TimeWarpEngineering/timewarp-nuru

Installation

dotnet tool install --global TimeWarp.Nuru.Search

Commands

Search for Commands

nuru search --query "commit"
nuru search --query "push" --group git
nuru search --query "build" --cli ganda

Options:

• --query / -q - Search terms (keyword matching)
• --group / -g - Filter by group path prefix
• --cli / -c - Limit results to a specific CLI
• --limit / -l - Maximum results (default: 50)

Index Management

nuru index list                    # Show indexed CLIs
nuru index rebuild --cli /path/to/cli  # Index a specific CLI
nuru index rebuild --all           # Rebuild all indexes
nuru index clear                   # Clear the entire index

How It Works

1. On-demand indexing - When you search, the tool checks if the CLI is indexed
2. Auto-index - If not indexed or version changed, runs cli --capabilities and indexes results
3. SQLite FTS5 - Full-text search with Porter stemmer for fast keyword matching
4. Database location - ~/.nuru/index.db

Search Behavior

• Keyword matching - Searches across pattern, description, and group path
• Case-insensitive - "Commit" and "commit" return same results
• Group filtering - Use --group to narrow to a specific command group
• CLI filtering - Use --cli to search within a specific application

Output Format

Returns JSON compatible with --capabilities output:

{
  "cli": "ganda",
  "version": "1.0.0",
  "query": "commit",
  "group": "git",
  "endpoints": [...]
}

Integration with Nuru CLIs

Any CLI built with TimeWarp.Nuru supports --capabilities output, which this tool indexes:

# Index any Nuru-based CLI
nuru index rebuild --cli /path/to/my-cli

# Then search across all indexed CLIs
nuru search --query "deploy"

Examples

# Find all commit-related commands
nuru search --query "commit"

# Find push commands in the git group
nuru search --query "push" --group git

# Search only within ganda CLI
nuru search --query "kanban" --cli ganda

# List what's indexed
nuru index list

# Rebuild index for a specific CLI after update
nuru index rebuild --cli /usr/local/bin/ganda