Metadata-Version: 2.5
Name: agentic-pydoc
Version: 0.1.0
Summary: Python codebase intelligence and documentation for AI agents.
License: MIT
Requires-Python: >=3.13
Requires-Dist: pydantic>=2.13.4
Requires-Dist: typer>=0.16.0
Description-Content-Type: text/markdown

# agentic-pydoc

Static Python codebase intelligence and documentation for AI agents.

## Installation

Requires Python 3.13+.

Install as an isolated tool (recommended):

```bash
uv tool install agentic-pydoc
```

Or with pipx:

```bash
python -m pip install --user pipx
python -m pipx ensurepath
pipx install agentic-pydoc
```

Then verify the install from any directory:

```bash
agentic-pydoc --help
agentic-pydoc --version
```

## Development

Contributors clone the repository and sync the environment instead:

```bash
git clone <repository-url>
cd agentic-pydoc
uv sync
uv run agentic-pydoc --help
```

## Commands

```bash
uv run agentic-pydoc scan
uv run agentic-pydoc update
uv run agentic-pydoc check
uv run agentic-pydoc history
uv run agentic-pydoc show sql_model.repositories.base.BaseRepository
uv run agentic-pydoc callers sql_model.repositories.base.BaseRepository.create
uv run agentic-pydoc callees sql_model.repositories.base.BaseRepository.create
uv run agentic-pydoc deps sql_model.repositories.base.BaseRepository
```

The tool generates `docs/reference/index.json` and MDX pages under
`docs/reference/`.

See the complete [API reference](docs/API_REFERENCE.md) for the CLI,
configuration, Python models, analyzers, index schema, and generators.

See [incremental indexing architecture](docs/incremental-indexing.md) for scan
baselines, Git updates, persistence, cache, and static-analysis limits.
