open-index/open-npm huggingface dataset:
npm package: @sapirrior/codefile
Description: Pack a project directory into a single structured text file for LLM context.
Latest version: 1.0.0

# CodeFile

A lightweight TypeScript tool to bundle a project directory into a single structured text file. Designed to provide comprehensive context for AI models with limited file upload capabilities and to facilitate easy project reconstruction.

## Features

- **Project Bundling**: Packs all project files (respecting `.gitignore`) into one `.txt` file.
- **Reconstruction**: Rebuilds the entire project structure from the bundle.
- **Visual Tree**: Generates a clear file structure overview in the output.
- **Binary Detection**: Automatically identifies and marks binary, empty, and symbolic link files.

## Installation

To install `CodeFile` from anywhere in your terminal:
```bash
npm install -g sapirrior/codefile-node
```

### Per-Project Installation
```bash
npm install sapirrior/codefile-node
```

## Usage

### If installed globally:
```bash
codefile [directory] [-o output.txt]
```

### If installed per-project:
```bash
./node_modules/.bin/codefile [directory] [-o output.txt]
```

### Options

- `-b, --build`: Reconstruct project from a pack file.
- `-o, --output`: Specify output path for packing or input path for building.
- `-h, --help`: Show help information.

## License
MIT