Metadata-Version: 2.4
Name: neux
Version: 0.3.3
Summary: Codebase nervous system — knowledge graph for AI-assisted development
Author: IronDevz
License: MIT
Project-URL: Homepage, https://github.com/IronDevz/neux
Project-URL: Repository, https://github.com/IronDevz/neux
Keywords: claude-code,codebase,graph,ast,context,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0
Requires-Dist: jinja2>=3.1
Requires-Dist: tree-sitter>=0.23
Requires-Dist: tree-sitter-language-pack>=0.4
Requires-Dist: anvl-monitor>=0.2.5
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Dynamic: license-file

# NEUX

> Codebase nervous system — knowledge graph for AI-assisted development.

NEUX is a Python CLI that builds a relationship graph of your codebase in SQLite,
detects patterns and conventions automatically (no LLM, pure AST), and integrates
with [Claude Code](https://claude.com/claude-code) via hooks to inject precise context
at the moment a tool call is about to modify a file.

Companion of [ANVL](https://github.com/juanlumanmx29/anvl). ANVL monitors tokens per
session. NEUX maps project intelligence.

⚒ forged by **IronDevz**

---

## Features (v0.1)

- SQLite knowledge graph with FTS5 full-text search
- Language scanners: Python (`ast`), React/JS/TS/JSX/TSX (tree-sitter), SQL
- 12 pattern/convention detectors (naming, imports, security, style, UI, API, data, state, errors, file structure, testing)
- Claude Code hooks that inject contextual rules before `Write`/`Edit`
- Auto-generated `CLAUDE.md` with module sub-manuals
- Impact analysis via recursive CTE (no networkx)

## Install

```bash
pip install -e .
```

## Usage

```bash
cd your-project
neux init               # initial scan, generates CLAUDE.md, installs hooks
neux status             # graph stats
neux impact <target>    # what breaks if you change this
neux scan --changed     # incremental rescan
```

## License

MIT © IronDevz
