neat.is
v0.4.2
Published
NEAT — live semantic graph of a software system, queryable from AI agents over MCP. Install once, get the neat / neatd / neat-mcp CLIs.
Readme
neat.is
NEAT keeps a live semantic graph of a software system — code, infrastructure, runtime — and exposes it to AI agents over MCP.
Prerequisites
- Node.js 20 or newer. Enforced via
engines; older versions fail at install. - A C toolchain, because
@neat.is/corebuilds native bindings fortree-sitter(JS, TS, Python parsers) at install time:- macOS: Xcode Command Line Tools (
xcode-select --install) - Debian/Ubuntu:
build-essentialpluspython3(fornode-gyp) - Alpine:
build-base python3 - Windows: Visual Studio Build Tools with the "Desktop development with C++" workload
- macOS: Xcode Command Line Tools (
If npm install -g neat.is fails partway through with a gyp error, the toolchain is the cause. Install it and re-run.
Install
npm install -g neat.isThat puts three binaries on your PATH:
neat— CLI (init, watch, list, skill, plus the nine query verbs that mirror the MCP tool surface)neatd— daemon (start, stop, status, reload)neat-mcp— MCP stdio server for Claude Code and other agents
Quick start
neat init /path/to/your/repo --project myrepo
neatd startSnapshot lands at <repo>/neat-out/myrepo.json. The daemon watches for file changes and OTel traces (:4318 HTTP by default) and keeps the graph live.
What's in the box
neat.is is an umbrella that pulls in:
@neat.is/core— graph engine, extractors, REST + OTel ingest@neat.is/mcp— MCP server exposing graph queries to agents@neat.is/claude-skill— drop-in Claude Code skill
License
BUSL-1.1. See neat.is for details.
