This content originally appeared on DEV Community and was authored by kkrishnan10
For Release 0.1, I created ContextWeaver, a command-line tool that packages the content of a local Git repository into a single text file optimized for Large Language Models (LLMs). The goal is to make it easier to share full project context with ChatGPT or other tools without manually copy-pasting many files.
Setup
I started by creating a new GitHub repository with a clear name, adding a README.md and LICENSE file. The README explains what the tool does, how to install it, and examples of usage.
Implemented Features
-CLI Interface: --help, --version, accepts file/directory paths
-File Discovery: can analyze current directory, specific directories, or specific files
-Output Format: includes absolute repo path, Git commit info, project structure, file contents, and summary stats
-Standard Streams: outputs to stdout, errors to stderr
-Error Handling: skips unreadable files and reports them
-Output to File: -o flag saves the context into a .txt or .md file
-Token Counting: --tokens flag gives an estimated token count
Example Usage
-Analyze current directory
python main.py .
-Save output to file
python main.py . -o output.txt
-Estimate token count
python main.py . --tokens
Sample run: main.py generates repo structure, file contents, and metadata in one output.
Reflection
While building this release, I learned:
-How to parse command-line arguments with argparse
-How to use Git commands to pull commit info
-How to walk through directories, skip hidden files, and include file contents
-How to handle large files by truncating output at 16KB
One challenge was deciding what to include vs skip for very large files. I solved this by limiting the file size and adding a truncation note.
This project gave me practice with CLI design, file system operations, and Git integration, while also teaching me the importance of clear documentation.
Links
Repo: https://github.com/kkrishnan10/ContextWeaver
Main script:
https://github.com/kkrishnan10/ContextWeaver/blob/main/src/main.py
README: https://github.com/kkrishnan10/ContextWeaver/blob/main/README.md
This content originally appeared on DEV Community and was authored by kkrishnan10
kkrishnan10 | Sciencx (2025-09-19T20:55:42+00:00) Release 0.1. Retrieved from https://www.scien.cx/2025/09/19/release-0-1/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.