Sourcegraph extensions add the following kinds of features to Sourcegraph and (using the Chrome/Firefox browser extensions) your code host and review tools:
The Sourcegraph.com extension registry contains all publicly available Sourcegraph extensions. You can use these extensions on Sourcegraph.com and on your own self-hosted Sourcegraph instance.
If you've used Sourcegraph before, you've used a Sourcegraph extension. For example, try hovering over tokens or toggling Git blame on tuf_store.go
. Or see a demo video of code coverage overlays. These features (and many others) are provided by extensions. You could improve these features, or add new features, just by improving or creating extensions to Sourcegraph.
Screenshots of test coverage and Git blame extensions:
To view all available extensions on your Sourcegraph instance, click User menu > Extensions in the top navigation bar. (To see recommended extensions, click Explore in the top navigation bar.)
To enable/disable an extension for yourself, click User menu > Extensions, find the extension, and toggle the slider.
After enabling a Sourcegraph extension, it is immediately ready to use. Of course, some extensions only activate for certain files (e.g., the Python extension only adds code intelligence for .py
files).
Install the browser extension and point it to your Sourcegraph instance (or Sourcegraph.com) in its options menu. It will consult your Sourcegraph user settings and activate the extensions you've enabled whenever you view code or diffs on your code host or review tool.
To enable/disable an extension for all organization members, add it to the extensions
object in organization settings (as shown below).
{ ..., "extensions": { ..., "alice/myextension": true, // or false to disable ... }, ... }
On a self-hosted Sourcegraph instance, add the same JSON above to global settings (in Site admin > Global settings).