Metadata-Version: 2.4
Name: llm-codepac
Version: 0.1.5
Summary: Generate structured Context Packs for AI coding tools by analyzing your codebase.
Author: ContextCraft
License: MIT
Project-URL: Homepage, https://abhiramvishal.github.io/ContextPacker
Project-URL: Repository, https://github.com/abhiramvishal/ContextPacker
Project-URL: Bug Tracker, https://github.com/abhiramvishal/ContextPacker/issues
Keywords: ai,llm,claude,context,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: anthropic>=0.18.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: tree-sitter>=0.20.0
Requires-Dist: tree-sitter-javascript>=0.20.0
Requires-Dist: tree-sitter-typescript>=0.20.0
Requires-Dist: tree-sitter-java>=0.20.0
Requires-Dist: pathspec>=0.12.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Dynamic: license-file

# ContextCraft

[![PyPI version](https://badge.fury.io/py/llm-codepac.svg)](https://pypi.org/project/llm-codepac/)

A Python CLI tool that analyzes a code repository and generates a structured **Context Pack** document optimized for injecting into AI coding tools (Claude, GPT, Cursor, Copilot) so they understand the codebase before writing code.

## Installation

### CLI

```bash
pip install llm-codepac
```

### VS Code Extension

Coming soon on the VS Code Marketplace.

## Usage

```bash
export ANTHROPIC_API_KEY=your_key_here
contextcraft init /path/to/your/repo
```

## Environment

Create a `.env` file (see `.env.example`) or set:

- `ANTHROPIC_API_KEY` — required for AI synthesis (omit or use `--no-ai` for offline)

## Output

- **Default:** `context.pack.md` in the repo root with a Quick Copy section and full Context Pack.
- **JSON:** Raw analysis or pack as JSON when `--format json` is used.

## Requirements

- Python 3.11+
- Git (optional; used for recent commits and hotspot analysis)

## Distribution

- **Install from PyPI:** `pip install llm-codepac`
- **Install the VS Code extension:** [ContextCraft on the Marketplace](https://marketplace.visualstudio.com/) (when published), or install manually: download the `.vsix` from [Releases](https://github.com/abhiramvishal/ContextPacker/releases) and run *Extensions: Install from VSIX...* in VS Code.
- **Publish a new Python release:** tag with `git tag v0.x.x && git push --tags` (triggers PyPI publish).
- **Publish a new extension release:** tag with `git tag ext-v0.x.x && git push --tags` (triggers VS Code Marketplace publish and uploads `.vsix` to the GitHub Release).
