Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@

## Comment Style

- Write comments in English.
Expand Down
58 changes: 52 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ An interactive CLI that makes installing dependencies easy — with first-class

<img height="500" alt="Ghostty 2026-03-11 01 32 41" src="https://github.com/user-attachments/assets/83d164f3-8a13-41f1-a453-23ffd81ed387" />


## 📦 Install

```bash
Expand All @@ -17,19 +16,28 @@ npm i -g @rizumu/nai

```bash
# Interactive mode — prompts for everything
nai
nai add

# Pass package names directly
# Pass package names directly (two ways)
nai react vue@^3.5 lodash
nai add react vue@^3.5 lodash

# Install as devDependencies
nai vitest -D
nai add vitest -D

# Install as peerDependencies
nai react --peer
nai add react --peer

# Specify a catalog
nai zod -C prod
nai add zod -C prod

# Update packages to latest versions
nai update
nai up react lodash

# Manage catalogs
nai catalog
nai catalog --list
```

Run `nai --help` for all available options.
Expand All @@ -56,6 +64,44 @@ Too many flags. Too many files to touch. Too many things to remember.
6. ✅ **Review & confirm** — colorful summary before any file is changed
7. 🚀 **Install** — writes config files and runs install for you

## 📋 Commands

| Command | Alias | Description |
|---------|-------|-------------|
| `nai [packages]` | `nai add` | Install packages interactively |
| `nai update [packages]` | `nai up` | Update packages to latest versions |
| `nai remove [packages]` | `nai rm` | Remove packages from dependencies |
| `nai catalog` | - | Browse and manage catalog versions |

### 📦 Update

Check and update outdated packages:

```bash
# Check all packages for updates
nai update

# Update specific packages
nai update react lodash

# Interactive mode
nai update -i
```

### 🗂️ Catalog

Browse catalogs and change dependency versions:

```bash
# Interactive catalog browser
nai catalog

# List all catalogs
nai catalog --list
```

Select packages within a catalog and choose new versions from npm.

## 🗂️ What is a Catalog?

Catalogs let you define dependency versions in one central place (e.g. `pnpm-workspace.yaml`) and reference them in `package.json` with `catalog:name`. This keeps versions consistent across a monorepo.
Expand Down
Loading