/scip

SCIP Code Intelligence Protocol

Primary LanguageRustApache License 2.0Apache-2.0

SCIP Code Intelligence Protocol

SCIP (pronunciation: "skip") is a language-agnostic protocol for indexing source code, which can be used to power code navigation functionality such as Go to definition, Find references, and Find implementations.

This repository includes:

  • A protobuf schema for SCIP.
  • Rich Go bindings for SCIP: This includes many utility functions to help build tooling on top of SCIP.
  • Auto-generated bindings for TypeScript, Rust and Haskell.
  • The scip CLI makes SCIP indexes a breeze to work with.

If you're interested in better understanding the motivation behind SCIP, check out the announcement blog post.

If you're interested in writing a new indexer that emits SCIP, check out our documentation on how to write an indexer. Also, check out the Debugging section in the Development docs.

If you're interested in consuming SCIP data, you can either use one of the provided language bindings, or generate code for the SCIP protobuf schema using the protobuf toolchain for your language ecosystem. Also, check out the Debugging section in the Development docs.

Tools using SCIP

Several indexers currently emit SCIP data: scip-java (for Java, Kotlin and Scala), scip-typescript, scip-python, scip-ruby and rust-analyzer.

For more details about indexers, including LSIF-based indexers, see the Sourcegraph documentation.

Other tools which use SCIP include the Sourcegraph CLI, and the SCIP CLI in this repo.

Installing the scip CLI

You can find binaries for the scip CLI tool here. You can also compile a binary locally using:

git clone https://github.com/sourcegraph/scip.git --depth=1
cd scip
go build -o scip ./cmd

You can consult the CLI reference or --help for usage information.

Contributing

We welcome questions, suggestions as well as code and docs contributions.

For submitting contributions, check out Development.md to better understand project structure and common workflows.

Contributors should abide by the Sourcegraph Code of Conduct.