Coder Sitter

A CLI tool to read and concatenate file contents for LLM context generation.

Installation

npm install @yiliang114/coder-sitter

Usage

Basic Usage

# Read all files in a directory
sitter ./src

# Ignore specific directories
sitter ./src --ignore test node_modules

# Only print directory tree
sitter ./src --tree-only

Command Options

• -i, --ignore <patterns...>: Directories or files to ignore (e.g., test, node_modules)
• --include <patterns...>: File patterns to include (default: all files)
• --max-size <bytes>: Maximum file size in bytes (default: 1MB)
• --encoding <encoding>: File encoding (default: utf-8)
• --tree-only: Only print directory tree structure
• --no-tree: Skip printing directory tree structure

Examples

# Read TypeScript files only, ignore test and node_modules
sitter ./src --include "**/*.ts" --ignore test node_modules

# Read with custom file size limit
sitter ./src --max-size 2097152  # 2MB

# Read with different encoding
sitter ./src --encoding utf8

# Only show directory structure
sitter ./src --tree-only

Programmatic Usage

import { CoderSitter } from '@yiliang114/coder-sitter';

const sitter = new CoderSitter({
  ignore: ['node_modules', '.git', 'dist'],
  include: ['**/*.ts', '**/*.js'],
  maxFileSize: 1024 * 1024, // 1MB
  encoding: 'utf-8'
});

// Print directory tree
await sitter.printTree('./src');

// Read and concatenate files
const content = await sitter.readDirectory('./src');
console.log(content);

Output Format

The tool outputs:

1. Directory Tree: A visual representation of the file structure
2. Concatenated Content: All file contents with clear separators and metadata

Example output:

📁 Directory structure for: /path/to/src

├── 📁 components
│   ├── 📄 Button.tsx
│   └── 📄 Header.tsx
└── 📄 index.ts

================================================================================
📄 File: components/Button.tsx
📏 Size: 2.1 KB
================================================================================

// Button component code here...

================================================================================
📄 File: components/Header.tsx
📏 Size: 1.8 KB
================================================================================

// Header component code here...

License

MIT