@diekotto/code-digest v3.1.1

Code Digest Generator

Coverage

Npm package

link: @diekotto/code-digest

A comprehensive tool for generating detailed code digests of your codebase, optimized for Large Language Model (LLM) context windows. Perfect for documentation, code analysis, and AI-assisted development.

Features

• 📊 Provides a concise metadata summary
• 📝 Generates a detailed digest of your codebase
• 🌳 Creates a visual directory tree structure
• 🚀 Fast execution with Node.js
• 🔒 Secure artifact storage
• ⚙️ Configurable file ignoring patterns
• 🔄 Compatible with CI/CD workflows

Usage Options

Option 1: GitHub Action

Add the following step to your GitHub Actions workflow:

- name: Generate Code Digest
  uses: diekotto/code-digest-action@v2
  with:
    directory: 'src'
    output-format: 'text'

Option 2: CLI Tool via NPX

Run directly without installing:

npx @diekotto/code-digest --directory ./src --output ./output

Option 3: Globally Installed CLI

Install globally:

npm install -g @diekotto/code-digest

Then use anywhere:

code-digest --directory ./src --format both

Configuration

GitHub Action Configuration

CLI Options

Output Files

The tool generates multiple files with a timestamp in the output directory:

• metadata-{timestamp}.json: Contains overall statistics and execution information
• tree-{timestamp}.txt: Text representation of the directory structure (if format includes 'text')
• tree-{timestamp}.json: JSON representation of the directory structure (if format includes 'json')
• digest-{timestamp}.txt: Detailed file information in text format (if format includes 'text')
• digest-{timestamp}.json: Detailed file information in JSON format (if format includes 'json')

Example Workflow

GitHub Actions Workflow

name: Generate Code Digest

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  digest:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Generate Code Digest
        uses: diekotto/code-digest-action@v2
        with:
          directory: 'src'
          output-format: 'both'
          ignore-patterns: 'node_modules,dist,coverage'

      - name: Download Digest Files
        uses: actions/download-artifact@v4
        with:
          name: code-digest-files

CLI Usage Examples

1. Generate digest for current directory:

npx @diekotto/code-digest

2. Generate digest for a specific directory with custom output location:

npx @diekotto/code-digest -d ./src -o ./output

3. Ignore specific patterns and set custom max file size:

npx @diekotto/code-digest -i "*.log,*.tmp" --max-size 5

Use Cases

• Code Reviews: Provide structured context for pull request reviews
• Documentation: Generate detailed codebase summaries
• AI Integration: Create optimized context for LLM-powered development tools
• Archival: Maintain searchable snapshots of your codebase

Security

This tool:

• Uses specific versions of dependent actions (when used as a GitHub Action)
• Runs in an isolated environment
• Doesn't require any sensitive permissions
• Stores artifacts securely

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Diego Maroto

Support

If you encounter any problems or have suggestions, please open an issue in the GitHub repository.