combicode 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 A. Aurelions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# Combicode
+
+[![NPM Version](https://img.shields.io/npm/v/combicode.svg)](https://www.npmjs.com/package/combicode)
+[![PyPI Version](https://img.shields.io/pypi/v/combicode.svg)](https://pypi.org/project/combicode/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<img align="center" src="https://github.com/aaurelions/combicode/raw/main/screenshot.png" width="600"/>
+
+**Combicode** is a zero-dependency CLI tool that intelligently combines your project's source code into a single, LLM-friendly text file.
+
+Paste the contents of `combicode.txt` into ChatGPT, Claude, or any other LLM to give it the full context of your repository instantly.
+
+## Why use Combicode?
+
+- **Maximum Context:** Give your LLM a complete picture of your project structure and code.
+- **Intelligent Ignoring:** Automatically skips `node_modules`, `.venv`, `dist`, `.git`, binary files, and other common junk.
+- **`.gitignore` Aware:** Respects your project's existing `.gitignore` rules out of the box.
+- **Zero-Install Usage:** Run it directly with `npx` or `pipx` without polluting your environment.
+- **Customizable:** Easily filter by file extension or add custom ignore patterns.
+
+## Quick Start
+
+Navigate to your project's root directory in your terminal and run one of the following commands:
+
+#### For Node.js/JavaScript/TypeScript projects (via `npx`):
+
+```bash
+npx combicode
+```
+
+#### For Python projects (or general use, via `pipx`):
+
+```bash
+pipx run combicode
+```
+
+This will create a `combicode.txt` file in your project directory.
+
+## Usage and Options
+
+### Preview which files will be included
+
+Use the `--dry-run` or `-d` flag to see a list of files without creating the output file.
+
+```bash
+# npx
+npx combicode --dry-run
+
+# pipx
+pipx run combicode -d
+```
+
+### Specify an output file
+
+Use the `--output` or `-o` flag.
+
+```bash
+npx combicode -o my_project_context.md
+```
+
+### Include only specific file types
+
+Use the `--include-ext` or `-i` flag with a comma-separated list of extensions.
+
+```bash
+# Include only TypeScript, TSX, and CSS files
+npx combicode -i .ts,.tsx,.css
+
+# Include only Python and YAML files
+pipx run combicode -i .py,.yaml
+```
+
+### Add custom exclude patterns
+
+Use the `--exclude` or `-e` flag with comma-separated glob patterns.
+
+```bash
+# Exclude all test files and anything in a 'docs' folder
+npx combicode -e "**/*_test.py,docs/**"
+```
+
+## All CLI Options
+
+| Option           | Alias | Description                                                  | Default         |
+| ---------------- | ----- | ------------------------------------------------------------ | --------------- |
+| `--output`       | `-o`  | The name of the output file.                                 | `combicode.txt` |
+| `--dry-run`      | `-d`  | Preview files without creating the output file.              | `false`         |
+| `--include-ext`  | `-i`  | Comma-separated list of extensions to exclusively include.   | (include all)   |
+| `--exclude`      | `-e`  | Comma-separated list of additional glob patterns to exclude. | (none)          |
+| `--no-gitignore` |       | Do not use patterns from the project's `.gitignore` file.    | `false`         |
+| `--version`      | `-v`  | Show the version number.                                     |                 |
+| `--help`         | `-h`  | Show the help message.                                       |                 |
+
+## License
+
+This project is licensed under the MIT License.

package/index.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const yargs = require("yargs/yargs");
+const { hideBin } = require("yargs/helpers");
+const glob = require("fast-glob");
+
+const { version } = require("./package.json");
+
+const DEFAULT_IGNORE_PATTERNS = [
+  "**/node_modules/**",
+  "**/.git/**",
+  "**/.vscode/**",
+  "**/.idea/**",
+  "**/*.log",
+  "**/.env",
+  "**/*.lock",
+  "**/.venv/**",
+  "**/venv/**",
+  "**/env/**",
+  "**/__pycache__/**",
+  "**/*.pyc",
+  "**/*.egg-info/**",
+  "**/build/**",
+  "**/dist/**",
+  "**/.pytest_cache/**",
+  "**/.npm/**",
+  "**/pnpm-lock.yaml",
+  "**/package-lock.json",
+  "**/.next/**",
+  "**/.DS_Store",
+  "**/Thumbs.db",
+  // Common binary file extensions
+  "**/*.png",
+  "**/*.jpg",
+  "**/*.jpeg",
+  "**/*.gif",
+  "**/*.ico",
+  "**/*.svg",
+  "**/*.webp",
+  "**/*.mp3",
+  "**/*.wav",
+  "**/*.flac",
+  "**/*.mp4",
+  "**/*.mov",
+  "**/*.avi",
+  "**/*.zip",
+  "**/*.tar.gz",
+  "**/*.rar",
+  "**/*.pdf",
+  "**/*.doc",
+  "**/*.docx",
+  "**/*.xls",
+  "**/*.xlsx",
+  "**/*.dll",
+  "**/*.exe",
+  "**/*.so",
+  "**/*.a",
+  "**/*.lib",
+  "**/*.o",
+  "**/*.bin",
+  "**/*.iso",
+];
+
+function isLikelyBinary(file) {
+  const buffer = Buffer.alloc(512);
+  let fd;
+  try {
+    fd = fs.openSync(file, "r");
+    const bytesRead = fs.readSync(fd, buffer, 0, 512, 0);
+    // Check for null bytes, a strong indicator of a binary file
+    return buffer.slice(0, bytesRead).includes(0);
+  } catch (e) {
+    // If we can't read it, treat it as something to skip
+    return true;
+  } finally {
+    if (fd) fs.closeSync(fd);
+  }
+}
+
+async function main() {
+  const argv = yargs(hideBin(process.argv))
+    .scriptName("combicode")
+    .usage("$0 [options]")
+    .option("o", {
+      alias: "output",
+      describe: "Output file name",
+      type: "string",
+      default: "combicode.txt",
+    })
+    .option("d", {
+      alias: "dry-run",
+      describe: "Preview files without creating the output file",
+      type: "boolean",
+      default: false,
+    })
+    .option("i", {
+      alias: "include-ext",
+      describe: "Comma-separated extensions to include (e.g., .js,.ts)",
+      type: "string",
+    })
+    .option("e", {
+      alias: "exclude",
+      describe: "Comma-separated glob patterns to exclude",
+      type: "string",
+    })
+    .option("no-gitignore", {
+      describe: "Ignore the project's .gitignore file",
+      type: "boolean",
+      default: false,
+    })
+    .version(version) // Read version from package.json
+    .alias("v", "version")
+    .help()
+    .alias("h", "help").argv;
+
+  const projectRoot = process.cwd();
+  console.log(`✨ Running Combicode in: ${projectRoot}`);
+
+  const ignorePatterns = [...DEFAULT_IGNORE_PATTERNS];
+
+  if (!argv.noGitignore) {
+    const gitignorePath = path.join(projectRoot, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+      console.log("🔎 Found and using .gitignore");
+      const gitignoreContent = fs.readFileSync(gitignorePath, "utf8");
+      ignorePatterns.push(
+        ...gitignoreContent
+          .split(/\r?\n/)
+          .filter((line) => line && !line.startsWith("#"))
+      );
+    }
+  }
+
+  if (argv.exclude) {
+    ignorePatterns.push(...argv.exclude.split(","));
+  }
+
+  let allFiles = await glob("**/*", {
+    cwd: projectRoot,
+    dot: true,
+    ignore: ignorePatterns,
+    absolute: true,
+    stats: false,
+  });
+
+  const allowedExtensions = argv.includeExt
+    ? new Set(
+        argv.includeExt
+          .split(",")
+          .map((ext) => (ext.startsWith(".") ? ext : `.${ext}`))
+      )
+    : null;
+
+  const includedFiles = allFiles
+    .filter((file) => {
+      if (fs.statSync(file).isDirectory()) return false;
+      if (isLikelyBinary(file)) return false;
+      if (allowedExtensions && !allowedExtensions.has(path.extname(file)))
+        return false;
+      return true;
+    })
+    .sort();
+
+  if (includedFiles.length === 0) {
+    console.error("❌ No files to include. Check your path or filters.");
+    process.exit(1);
+  }
+
+  if (argv.dryRun) {
+    console.log("\n📋 Files to be included (Dry Run):");
+    includedFiles.forEach((file) =>
+      console.log(`  - ${path.relative(projectRoot, file)}`)
+    );
+    console.log(`\nTotal: ${includedFiles.length} files.`);
+    return;
+  }
+
+  const outputStream = fs.createWriteStream(argv.output);
+  for (const file of includedFiles) {
+    const relativePath = path.relative(projectRoot, file).replace(/\\/g, "/");
+    outputStream.write(`// FILE: ${relativePath}` + "\n");
+    outputStream.write("```\n");
+    const content = fs.readFileSync(file, "utf8");
+    outputStream.write(content);
+    outputStream.write("\n```\n\n");
+  }
+  outputStream.end();
+
+  console.log(
+    `\n✅ Success! Combined ${includedFiles.length} files into '${argv.output}'.`
+  );
+}
+
+main().catch((err) => {
+  console.error(`An unexpected error occurred: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "combicode",
+  "version": "1.0.2",
+  "description": "A CLI tool to combine a project's codebase into a single file for LLM context.",
+  "main": "index.js",
+  "bin": {
+    "combicode": "index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aaurelions/combicode.git"
+  },
+  "keywords": [
+    "cli",
+    "llm",
+    "ai",
+    "context",
+    "prompt",
+    "developer-tool",
+    "codegen",
+    "chatgpt"
+  ],
+  "author": "A. Aurelions",
+  "license": "MIT",
+  "dependencies": {
+    "fast-glob": "^3.3.1",
+    "ignore": "^5.2.4",
+    "yargs": "^17.7.2"
+  }
+}