itap-cli-demo/README.md

> A lightweight, AI-powered npm package finder — directly from your terminal.

# itap

> A lightweight, AI-powered npm package finder — directly from your terminal.

![Demo](https://i.imgur.com/omBLN8G.gif)

## Features

* 🔍 **Semantic Search**
  Understands vague queries like “cool typing effect” or “dropdown animation” using embeddings and vector similarity.

* ⚡ **Instant Install**
  Select a package and immediately install it without leaving the terminal.

* 🔢 **Sort & Paginate**
  Sort by downloads, stars, update date, or the community score.

## 📦 Installation

```bash
npm install -g itap-cli-demo
```

## 🛠 Usage

```bash
# Basic search
itap "your search query"

# Search and sort results automatically
itap "drag drop" --sort downloads
itap "react table" -s stars
```

**Options:**

* `-s, --sort <type>` — Sort the results automatically without prompting.
  Available values:

  * `downloads` *(default)*
  * `stars`
  * `lastUpdated`
  * `itapScore` – Custom ranking metric calculated based on user interaction data.
* `-h, --help` — Show help.
* `-V, --version` — Show version.

**Example:**

```bash
# Search for packages related to file upload, sorted by stars
itap "file upload" --sort stars
```

## 📄 License

MIT © [Ribhav Sharma](https://github.com/ribhavsharma)