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.

Maintained in timewarp-nuru · Canonical file: SKILL.md

Install

npx skills add TimeWarpEngineering/timewarp-nuru --skill cli-search

Or copy the SKILL.md into your agent's skills directory.

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

On-demand indexing - When you search, the tool checks if the CLI is indexed
Auto-index - If not indexed or version changed, runs cli --capabilities and indexes results
SQLite FTS5 - Full-text search with Porter stemmer for fast keyword matching
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