typgrap

A minimal CLI to install packages with their corresponding @types – with support for Bun, PNPM, and NPM.

Features

• Automatically installs the @types/<package> if available
• Supports bun, pnpm, and npm
• Detects package manager from lockfiles or user config
• Customizable via .typgrap.json
• Clean and modern CLI UX
• Built with Bun for fast performance

Installation

Coming soon to npm...

npm install -g typgrap

or

bun add -g typgrap

Usage

typgrap install express

This will:

1. Detect your package manager (bun, pnpm, npm)
2. Install express
3. Try to install @types/express if available

Configuration

You can create a .typgrap.json file at the root of your project to set default options:

{
  "defaultPackageManager": "bun"
}

This overrides auto-detection and always uses the specified package manager.

How It Works

1. Detects the package manager by checking for:
   • bun.lockb → Bun
   • pnpm-lock.yaml → PNPM
   • package-lock.json → NPM
2. Installs your package using the correct command
3. Checks if a matching @types/ package exists
4. Installs it as a dev dependency if found

CLI Options (coming soon)

• --no-types → skip installing @types
• --force → override existing installations
• --config <path> → specify a custom config file path

Example

typgrap install mongoose

If you're using Bun, the tool will run:

bun add mongoose && bun add -d @types/mongoose

Only if @types/mongoose exists.

Author

Created by Ahmed Khalid (@ahmedkhalid-dev)

License

MIT