pkgmgr 1.0.0 → 1.1.0

package/README.md

@@ -24,6 +24,10 @@ pkgmgr exec vitest      # runs: <detected-pm> exec vitest
 
 ## Available Binaries
 
+### Package Manager Binaries (`pkgmgr`)
+
+Forward commands directly to the detected package manager.
+
 | Binary | Fallback |
 |--------|----------|
 | `pkgmgr` | npm |
@@ -31,6 +35,22 @@ pkgmgr exec vitest      # runs: <detected-pm> exec vitest
 | `pkgmgr-pnpm` | pnpm |
 | `pkgmgr-yarn` | yarn |
 
+### Exec Binaries (`pkgmgrx`)
+
+Forward commands to the detected package manager's "exec" equivalent.
+
+| Binary | Fallback | Executes |
+|--------|----------|----------|
+| `pkgmgrx` | npm | `npx <args>` |
+| `pkgmgrx-bun` | bun | `bunx <args>` |
+| `pkgmgrx-pnpm` | pnpm | `pnpm dlx <args>` |
+| `pkgmgrx-yarn` | yarn | `yarn dlx <args>` |
+
+```bash
+pkgmgrx cowsay "Hello"    # runs: npx cowsay "Hello" (or bunx, pnpm dlx, yarn dlx)
+pkgmgrx tsc --version     # runs: npx tsc --version
+```
+
 All binaries use the same detection logic. The only difference is which package manager is used when detection fails (no `PKGMGR` env var and no `npm_config_user_agent`).
 
 ## Detection Logic

package/bin/lib.js

@@ -1,5 +1,13 @@
 const SUPPORTED = new Set(['npm', 'pnpm', 'yarn', 'bun'])
 
+// Maps package manager to its "exec" command equivalent
+const EXEC_COMMANDS = {
+  npm: { bin: 'npx', args: [] },
+  pnpm: { bin: 'pnpm', args: ['dlx'] },
+  yarn: { bin: 'yarn', args: ['dlx'] },
+  bun: { bin: 'bunx', args: [] },
+}
+
 export function detectPackageManager(fallback = 'npm') {
   // 1. Explicit override via environment variable
   const envOverride = process.env.PKGMGR
@@ -45,3 +53,32 @@ export async function run(fallback = 'npm') {
     process.exit(code ?? 0)
   })
 }
+
+export async function runExec(fallback = 'npm') {
+  const pm = detectPackageManager(fallback)
+  const args = process.argv.slice(2)
+
+  if (args.length === 0) {
+    console.error('pkgmgrx: no command specified')
+    process.exit(1)
+  }
+
+  const { bin, args: prefixArgs } = EXEC_COMMANDS[pm]
+  const command = [...prefixArgs, ...args]
+
+  const { spawn } = await import('node:child_process')
+
+  const child = spawn(bin, command, {
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  })
+
+  child.on('error', (err) => {
+    console.error(`pkgmgrx: failed to execute ${bin}: ${err.message}`)
+    process.exit(1)
+  })
+
+  child.on('close', (code) => {
+    process.exit(code ?? 0)
+  })
+}

package/bin/pkgmgrx-bun.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('bun')

package/bin/pkgmgrx-pnpm.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('pnpm')

package/bin/pkgmgrx-yarn.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('yarn')

package/bin/pkgmgrx.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runExec } from './lib.js'
+runExec('npm')

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "pkgmgr",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Forward commands to the package manager you're already using",
   "bin": {
     "pkgmgr": "./bin/pkgmgr.js",
     "pkgmgr-bun": "./bin/pkgmgr-bun.js",
     "pkgmgr-pnpm": "./bin/pkgmgr-pnpm.js",
-    "pkgmgr-yarn": "./bin/pkgmgr-yarn.js"
+    "pkgmgr-yarn": "./bin/pkgmgr-yarn.js",
+    "pkgmgrx": "./bin/pkgmgrx.js",
+    "pkgmgrx-bun": "./bin/pkgmgrx-bun.js",
+    "pkgmgrx-pnpm": "./bin/pkgmgrx-pnpm.js",
+    "pkgmgrx-yarn": "./bin/pkgmgrx-yarn.js"
   },
   "files": [
     "bin"