agenticstackfile

AgenticStack

Instant codebase map for AI agents — understand any Python 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, service, and utility lives
• Which files to touch when making a specific change
• How your project is structured by framework (Django, Flask, FastAPI, or plain Python)
• A step-by-step change guide using your actual file paths

Installation

pip install agenticstackfile

With AI support:

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

With auto-sync (watch mode):

pip install 'agenticstackfile[watch]'

Everything at once:

pip install 'agenticstackfile[all]'

Usage

agenticstack init      # First-time setup — creates config and ignore file
agenticstack update    # Manually refresh AgenticStack.txt
agenticstack watch     # Auto-sync mode — watches for file changes and syncs automatically

Auto-sync (Watch Mode)

agenticstack watch runs two background services:

• Watcher — monitors your project for file changes in real time
• Scheduler — syncs AgenticStack.txt automatically based on your configured interval

Only syncs when files have actually changed — no wasted API tokens.

Requires watchdog: pip install 'agenticstackfile[watch]'

Modes

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

AI mode — provide an API key and Claude or GPT generates rich, detailed documentation with change guides tailored to your framework.

Configuration

Edit .agenticstack.ini in your project root:

[agenticstack]
provider = anthropic
model = default
api_key = YOUR_API_KEY
output_file = AgenticStack.txt
depth = standard
sync_trigger = false
sync_time = hourly

Ignoring Files

Create .agenticstackignore in your project root (auto-created by agenticstack init):