CLI Reference

Installation

Srcpack runs without global install:

npm

npx srcpack [command] [options]

bun

bunx srcpack [command] [options]

pnpm

pnpm dlx srcpack [command] [options]

yarn

yarn dlx srcpack [command] [options]

Or install as a dev dependency:

npm

npm install -D srcpack

bun

bun add -D srcpack

pnpm

pnpm add -D srcpack

yarn

yarn add -D srcpack

Commands

srcpack (default)

Bundle all configured bundles and upload if configured.

npm

npx srcpack

bun

bunx srcpack

pnpm

pnpm dlx srcpack

yarn

yarn dlx srcpack

With specific bundles:

npm

npx srcpack web api

bun

bunx srcpack web api

pnpm

pnpm dlx srcpack web api

yarn

yarn dlx srcpack web api

srcpack init

Create a srcpack.config.ts interactively.

npm

npx srcpack init

bun

bunx srcpack init

pnpm

pnpm dlx srcpack init

yarn

yarn dlx srcpack init

Detects your project structure and suggests bundle configurations.

srcpack login

Authenticate with Google Drive for uploads.

npm

npx srcpack login

bun

bunx srcpack login

pnpm

pnpm dlx srcpack login

yarn

yarn dlx srcpack login

Opens a browser to authorize access. Tokens are stored in ~/.config/srcpack/credentials.json.

Options

Option	Description
--dry-run	Preview bundles without writing files
--no-upload	Bundle only, skip upload
--help	Show help
--version	Show version

Examples

Preview without writing

npm

npx srcpack --dry-run

bun

bunx srcpack --dry-run

pnpm

pnpm dlx srcpack --dry-run

yarn

yarn dlx srcpack --dry-run

Output:

[dry-run] web  →  .srcpack/web.txt  (24 files, 8.2 KB)
[dry-run] api  →  .srcpack/api.txt  (18 files, 5.1 KB)

Bundle without upload

npm

npx srcpack --no-upload

bun

bunx srcpack --no-upload

pnpm

pnpm dlx srcpack --no-upload

yarn

yarn dlx srcpack --no-upload

Exit Codes

Code	Meaning
0	Success
1	Error (config, IO, etc)

Config File Locations

Srcpack searches for config in order:

1. srcpack.config.ts
2. srcpack.config.js
3. srcpack field in package.json

Searches from current directory up to filesystem root.