Skip to main content

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
Key Values Description
provider anthropic, openai AI provider to use
model default, or model name Model to use. default picks the best available.
api_key your key API key for AI mode
output_file filename Output file name
depth standard Analysis depth
sync_trigger true, false Enable auto-sync in watch mode
sync_time realtime, hourly, daily How often to sync when changes are detected

Ignoring Files

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

Metadata

Release files for agenticstackfile 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agenticstackfile 0.2.1
File Size Uploaded Provenance Actions
agenticstackfile-0.2.1.tar.gz 11.5 kB Without provenance Details for agenticstackfile-0.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agenticstackfile 0.2.1
File Interpreter ABI Platform Actions
agenticstackfile-0.2.1-py3-none-any.whl Python 3 none any Details for agenticstackfile-0.2.1-py3-none-any.whl

Total release size: 26.1 kB

Release files / agenticstackfile-0.2.1.tar.gz

Download URL agenticstackfile-0.2.1.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
041ca5a32e278b0ebe26be29fbe7c007f46d1cdc2f9510390432db77e6ba997b
BLAKE2b-256 checksum
How to use checksums
a9b27d08fc49394c84cafb9703d032fb887bcc0a7f84885feb3aee223baaeb06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / agenticstackfile-0.2.1-py3-none-any.whl

Download URL agenticstackfile-0.2.1-py3-none-any.whl
Size 14.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d01bbb6850aa0515277ee2c6f4f7279c291148c69aba5ea90e3e8ae4410c0983
BLAKE2b-256 checksum
How to use checksums
7ca1dd947ab1010dbd2cf298125b180da8fdba9fe899c4b33ead9bdc465f7af1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for agenticstackfile 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page