Skip to main content

Codebase nervous system — knowledge graph for AI-assisted development

Project description

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 via hooks to inject precise context at the moment a tool call is about to modify a file.

Companion of 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

pip install -e .

Usage

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neux-0.3.1.tar.gz (258.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neux-0.3.1-py3-none-any.whl (269.9 kB view details)

Uploaded Python 3

File details

Details for the file neux-0.3.1.tar.gz.

File metadata

  • Download URL: neux-0.3.1.tar.gz
  • Upload date:
  • Size: 258.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.7

File hashes

Hashes for neux-0.3.1.tar.gz
Algorithm Hash digest
SHA256 f26505a8d48894c414a38fc054d708228f2cddb8c35167cfcad245472537d717
MD5 d3a25bcec958966e4fb8451b71186de9
BLAKE2b-256 35475dd86ca9900ee8e220eb519538c4986bac40fb605a1fec5b50a5874cde29

See more details on using hashes here.

File details

Details for the file neux-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: neux-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 269.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.7

File hashes

Hashes for neux-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0fd6c35f99a6902fe447e8cea2c19c59b75986a91b0b3a3f9055a1a2c33a1d8d
MD5 a15d662493e8b5b34748559d69826a03
BLAKE2b-256 f9f41227850db582407aaabd558441a278bcb06cd960457a073647aa4cfb8195

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page