Metadata-Version: 2.5
Name: codeatlas-cli
Version: 0.1.0
Summary: Local codebase intelligence engine: AST-driven code IR, knowledge graph, living wiki, and hybrid search CLI.
Project-URL: Homepage, https://github.com/adityaiitg/codeatlas
Project-URL: Repository, https://github.com/adityaiitg/codeatlas
Project-URL: Issues, https://github.com/adityaiitg/codeatlas/issues
Author: Aditya Pratap Singh
License: MIT
License-File: LICENSE
Keywords: ast,bm25,code-search,codebase-intelligence,developer-tools,hybrid-search,knowledge-graph,living-wiki,tree-sitter
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: fastembed>=0.6.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: litellm>=1.50.0
Requires-Dist: networkx>=3.2.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: rich>=14.0.0
Requires-Dist: sqlite-vec>=0.1.6
Requires-Dist: tree-sitter-python>=0.23.0
Requires-Dist: tree-sitter>=0.24.0
Requires-Dist: typer>=0.15.0
Provides-Extra: dev
Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# CodeAtlas

Local codebase intelligence engine: AST-driven code IR, deterministic knowledge graph, living repo wiki, and hybrid search CLI.

## Features

- **Canonical Code IR**: Extracts semantic code symbols (classes, functions, methods, docstrings, calls, types) using Tree-sitter.
- **Code Knowledge Graph**: Tracks caller/callee relationships, imports, type hierarchies, and references in SQLite and NetworkX.
- **Hybrid Search Engine**: Reciprocal Rank Fusion (RRF) combining SQLite FTS5 (BM25 lexical search) and dense vector embeddings (`fastembed`).
- **Graph Neighborhood Expansion**: Expands search retrieval with 1–2 hop dependency context.
- **Living Repo Wiki**: Automatically generates and maintains architecture and module documentation with Mermaid diagrams.
- **Interactive CLI**: Fast terminal commands for indexing, querying, graph visualization, impact analysis, and wiki browsing.

## Installation

```bash
pip install codeatlas-cli
```
Or for local development:
```bash
uv pip install -e ".[dev]"
```

## Quickstart

```bash
# Index current repository
codeatlas index .

# Search code and architecture
codeatlas search "authentication middleware"

# Inspect symbol call graph
codeatlas graph "AuthMiddleware.authenticate"

# Analyze change blast radius
codeatlas impact "TokenService"

# Start MCP server
codeatlas mcp
```
