timewarpengineering/timewarp-nuru/tw-cli-search

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