Metadata-Version: 2.4
Name: agenticstackfile
Version: 0.1.3
Summary: Instant codebase map for AI agents — understand any project before making changes
Author-email: Rajat Handa <handarajat111@gmail.com>
License-Expression: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == "openai"
Provides-Extra: all
Requires-Dist: anthropic>=0.20.0; extra == "all"
Requires-Dist: openai>=1.0.0; extra == "all"

# AgenticStack

Instant codebase map for AI agents — understand any project before making changes.

## What it does

AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:

- Where every model, view, serializer, and service lives
- Which files to touch when making a specific change
- Which models are exposed via API vs internal only
- Step by step how-to guides using your actual file paths

## Installation

```bash
pip install agenticstackfile
```

With AI support:

```bash
pip install 'agenticstackfile[openai]'
pip install 'agenticstackfile[anthropic]'
```

## Usage

```bash
agenticstack init      # First time setup
agenticstack update    # Refresh AgenticStack.txt
```

## Modes

**Static mode** — no API key needed. Uses Python AST to analyze your codebase for free.

**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation.

## Configuration

Edit `.agenticstack.ini` in your project root:

```ini
[agenticstack]
model = default
api_key = YOUR_API_KEY
provider = anthropic
output_file = AgenticStack.txt
```

## Supported providers

- `anthropic` — Claude Sonnet, Haiku, Opus
- `openai` — GPT-4o, GPT-4o-mini
