Skip to content

An interactive CLI tool to create AI-friendly context from selected files.

License

Notifications You must be signed in to change notification settings

alwalxed/context-dump

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Context Dump for AI

An interactive CLI tool to generate AI-friendly context from selected files, making project data easily consumable for AI models.

Features

  • Interactive File Selection: Choose files using a checkbox interface.
  • Intelligent File Filtering: Automatically ignores common files and directories (e.g., node_modules, .git).
  • .gitignore Compliance: Respects .gitignore rules to streamline file selection.
  • Structured JSON Output: Outputs a JSON file containing the project structure and file contents.

Installation

Install the tool globally with:

npm install -g context-dump

Usage

Basic Command

Run the tool with a simple command:

context-dump

By default, the output is saved to ai_context.json in the current directory.

Options

Specify Output File

Use the -o or --output option to specify a custom output file:

context-dump -o custom_output.json

Exclude Specific Files or Folders

Use the -e or --exclude option to exclude specific files or folders (comma-separated):

context-dump -e foo,bar

Screenshots

context-dump-for-ai

Output Structure

The output JSON file contains two main sections:

  • project_structure: A list of file paths included in the output.
  • file_contents: A dictionary where keys are file paths, and values include the file content and extension.

Example Output

{
  "project_structure": ["example.js"],
  "file_contents": {
    "example.js": {
      "content": "console.log('Hello, World!');",
      "extension": "js"
    }
  }
}

Contributing

Submit issues or pull requests to help improve this tool.

License

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