cli-ninja

Navigate codebases with fd, rg, ast-grep, fzf, jq, and yq.

2|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/pythoninthegrasses/cli-ninja --skill cli-ninja
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-ninja
Source: https://github.com/pythoninthegrasses/cli-ninja/tree/main/cli-ninja
Command: npx skills add https://github.com/pythoninthegrasses/cli-ninja --skill cli-ninja

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ast-grep, fzf, bat, rg, jq, pbcopy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Navigating and exploring large codebases can be repetitive and error-prone without a guided workflow. cli-ninja provides a structured, tool-driven approach that helps you locate files, inspect code structure, and extract data using a curated set of modern CLI tools.

Core Features & Use Cases

  • Guided repository navigation with fd for fast file discovery.
  • Text and code search using rg and ast-grep to find patterns reliably.
  • Interactive selection and preview with fzf to accelerate decision-making.
  • JSON and YAML processing with jq and yq for structured data tasks.
  • Reusable workflows and references to proven patterns for common tasks.

Quick Start

Tell the AI to generate a guided repository-navigation plan using fd, rg, ast-grep, fzf, jq, and yq.

Frequently Asked Questions about cli-ninja

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I explore and navigate a large codebase using command line tools?

Codebase navigation uses a tool-driven workflow combining fd for file discovery, rg for text search, and ast-grep for structural code-pattern discovery to locate and inspect files reliably.

What is the best way to search for specific code patterns across a repository?

Searching code patterns across a repository is best handled by ast-grep for structural matching and rg for text search, with fzf providing interactive selection and preview to accelerate decision-making.

Do I need jq and yq installed to extract data from JSON and YAML files?

Yes, extracting data from JSON and YAML files requires jq and yq installed, as these CLI tools handle structured data processing and extraction within the guided workflow.

Can I use fzf to interactively preview search results while exploring code?

Yes, fzf provides interactive selection and preview capabilities that accelerate decision-making when navigating files or reviewing search results during repository exploration.

How do I parse and extract specific fields from JSON data in the terminal?

Parsing and extracting specific fields from JSON data in the terminal is done using jq to filter and extract structured data, often combined with yq for YAML processing in the same workflow.

Why use ast-grep instead of regular expressions for code exploration?

Ast-grep uses structural matching instead of regular expressions for code-pattern discovery, making it more reliable by understanding syntax structure rather than matching raw text strings.