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.txtautomatically 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.