Skip to content

1.0.0

Latest

Choose a tag to compare

@Third-Thing Third-Thing released this 22 Jul 01:28
f04bf33

scalps

scalps (scalpel search) is a local C++ definition search tool. It incrementally indexes functions and methods with Clang, then ranks whole definitions for short queries such as set line wrap mode or show an autocomplete list.

Why use it?

Normally, coding agents start a session by groping their way around the repository with grep, and then use sed to look at best-guess slices of code. Semantic search tools like grepai are supposed to help with that, but in practice they produce inconsistent results that might end up just adding more noise.

scalps searches definitions rather than arbitrary text windows. It uses C++ identifier structure, operation words, signatures, documentation, resolved relationships, bodies, and paths to distinguish nearby candidates.

scalps search returns a ranked list of functions and their exact line span. From there you can use scalps context to see the whole function and comment, and optionally the functions on either side for extra context.

scalps runs locally and does not require a model or remote service. It currently supports C++ function and method definitions. Indexing plans no-op, selective, or clean full updates and publishes only a complete validated generation when an update is needed.


The RPM below was built on openSUSE Leap 16.

zypper in scalps-1.0.0-0.x86_64.rpm

Or build from source and install locally with:

zypper in cmake gcc-c++ llvm19-devel clang19-devel jsoncpp-devel sqlite3-devel
./install.sh