Srcpack

Zero-config CLI for bundling code into LLM-optimized context files.

Requirements: Node.js 20+ or Bun

Quick Start

npx srcpack init         # Create config interactively
npx srcpack              # Bundle all

Why

LLM context fails when codebases are large, noisy, or poorly organized. Srcpack lets you split code into semantic bundles (e.g., web, api, docs) with clear file boundaries and an index header—optimized for ChatGPT, Claude, Gemini, etc.

Configuration

Create srcpack.config.ts in your project root:

import { defineConfig } from "srcpack";

export default defineConfig({
  bundles: {
    web: "apps/web/**/*",
    api: ["apps/api/**/*", "!apps/api/**/*.test.ts"],
    docs: {
      include: "docs/**/*",
      index: false, // disable index header
    },
  },
});

Or add to package.json:

{
  "srcpack": {
    "bundles": {
      "web": "apps/web/**/*"
    }
  }
}

Options

| Option | Default | Description | | ------------- | ---------- | -------------------------------------- | | outDir | .srcpack | Output directory for bundles | | emptyOutDir | true* | Empty output directory before bundling | | bundles | — | Named bundles with glob patterns | | upload | — | Upload destination(s) |

*emptyOutDir defaults to true when outDir is inside project root. When outDir is outside root, a warning is emitted unless explicitly set.

Bundle Config

// Simple glob
"src/**/*"

// Array with exclusions (! prefix)
["src/**/*", "!src/**/*.test.ts"]

// Force-include gitignored files (+ prefix)
["docs/**/*", "+docs/**/*.local.md"]

// Full options
{
  include: "src/**/*",
  outfile: "~/Downloads/bundle.txt",   // custom output path
  index: true,                         // include index header (default)
  prompt: "./prompts/review.md"        // prepend from file (or inline text)
}

Patterns follow glob syntax. Prefix with ! to exclude, + to force-include (bypasses .gitignore). Binary files are excluded.

Google Drive Upload

To upload bundles to Google Drive, add OAuth credentials to your config:

export default defineConfig({
  bundles: {
    /* ... */
  },
  upload: {
    provider: "gdrive",
    folderId: "1ABC...", // Google Drive folder ID (from URL)
    clientId: "...",
    clientSecret: "...",
    exclude: ["local"], // skip specific bundles
  },
});

Setup:

1. Go to Google Cloud Console
2. Create a project (or select existing)
3. Enable the Google Drive API
4. Go to Credentials → Create Credentials → OAuth client ID
5. Select Desktop app, then copy the client ID and secret
6. Run npx srcpack login to authenticate

Output Format

# Index (3 files)
# [1]   src/index.ts  L1-L42 (42 lines)
# [2]   src/utils.ts  L43-L89 (47 lines)
# [3]   src/api.ts    L90-L150 (61 lines)

#==> [1] src/index.ts <==
import { utils } from "./utils";
...

#==> [2] src/utils.ts <==
export function utils() {
...

• Numbered entries for easy cross-reference in conversations
• Line ranges point to actual content lines
• # prefix keeps format safe inside code blocks

CLI

npx srcpack                 # Bundle all, upload if configured
npx srcpack web api         # Bundle specific bundles only
npx srcpack --dry-run       # Preview without writing files
npx srcpack --emptyOutDir   # Empty output directory before bundling
npx srcpack --no-emptyOutDir # Keep existing files in output directory
npx srcpack --no-upload     # Bundle only, skip upload
npx srcpack init            # Interactive config setup
npx srcpack login           # Authenticate with Google Drive

API

import { defineConfig, loadConfig } from "srcpack";

// In config files
export default defineConfig({
  bundles: { web: "apps/web/**/*" },
});

// Programmatic
const config = await loadConfig();

LLM Context

• https://kriasoft.com/srcpack/llms.txt
• https://kriasoft.com/srcpack/llms-full.txt

Community

• Discord — Questions, feedback, and discussion
• GitHub Issues — Bug reports and feature requests

New contributors and OSS maintainers are welcome — join us on Discord or open an issue / PR.

Backers

License

MIT