nitpick-tools

🚧 Rebrand in progress: Nitpick is becoming Nitpick. This tooling repo still uses Nitpick names while the migration is underway. Editor grammars, generated extension assets, and tool command names need compatibility planning before any breaking rename.

Developer tools for the Nitpick programming language.

Components

nitpick-ls (Language Server)

LSP-compatible language server bundled with the main compiler. Provides diagnostics, hover, go-to-definition, completion, document symbols, references, and signature help. Source lives in the nitpick repo at src/tools/lsp/.

nitpick-safety (Static Auditor)

Static safety audit tool for Nitpick source files. Written in C. Scans for wild/raw/drop/ok usages, relaxed atomics, FFI boundaries, unsafe blocks, and trivial failsafe handlers.

cd nitpick-safety && make
./nitpick-safety path/to/file.npk
./nitpick-safety --json path/to/project/   # JSON output
./nitpick-safety --summary path/to/project/# per-tag statistics

nitpick-mcp (MCP Server)

Model Context Protocol server for AI-assisted Nitpick development. Zero external dependencies — pure Python 3.8+ stdlib. Provides 5 tools: nitpick_compile, nitpick_check, nitpick_docs, nitpick_format, nitpick_ask.

python3 nitpick-mcp/nitpick_mcp.py

VS Code Extension

Full VS Code extension with TextMate syntax highlighting, LSP integration (nitpick-ls), DAP debug adapter integration, and language configuration. Located in editors/vscode/.

Editor Support

• tree-sitter-nitpick — Tree-sitter grammar for Neovim, Helix, and other tree-sitter editors
• emacs — Emacs major mode (nitpick-mode.el) with full syntax highlighting, indentation, and typed literal support
• vscode-nitpick — Legacy VS Code syntax extension (superseded by editors/vscode/)

License

AGPL-3.0 — see LICENSE.md