Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

srclib-go Build Status

srclib-go is a srclib toolchain that performs Go code analysis: type checking, documentation generation, jump-to-definition, dependency resolution, etc.

It enables this functionality in any client application whose code analysis is powered by srclib, including

Screenshots are below.


This toolchain is not a standalone program; it provides additional functionality to applications that use srclib.

First, install the srclib program (see srclib installation instructions).

Then run:

# download and fetch dependencies
go get -v
cd $GOPATH/src/

# build the srclib-go program in .bin/srclib-go (this is currently required by srclib to discover the program)

# link this toolchain in your SRCLIBPATH (default ~/.srclib) to enable it

To verify that installation succeeded, run:

srclib toolchain list

You should see this srclib-go toolchain in the list.

Now that this toolchain is installed, any program that relies on srclib will support Go.


Here's what srclib-go's analysis looks like in these applications.

The first screenshot shows the http.NewRequest function on Here, srclib-go enables clickable links for every identifier (that take you to their definitions), automatic cross-repository usage examples, type inference, and documentation generation.


The second screenshot shows the emacs-sourcegraph-mode plugin for Emacs with this toolchain installed. Here, srclib-go enables jump-to-definition, type inference, documentation generation, and automatic cross-repository usage examples from All code analysis is performed locally by srclib using this toolchain.



srclib-go only works with code that exists in a proper GOPATH. When you run the src tool, it should use this GOPATH environment variable.

Srcfile configuration

Go repositories built with this toolchain may specify the following properties in their Srcfile's Config property:

  • GOROOT: a directory that should be used as the GOROOT when building Go packages in the directory tree. If relative, it is made absolute by prefixing the directory containing the Srcfile.

    Setting GOROOT (to .) is how srclib-go builds the standard library from the repository without having the system Go stdlib packages interfere with analysis.

  • GOPATH: a colon-separated list of directories that are appended to the build GOPATH. If relative, the dirs are made absolute by prefixing the directory containing the Srcfile.

    Set GOPATH when you have vendored dependencies within your repository that you import using import paths relative to the vendored dir (as with godep and third_party.go).

Known issues

srclib-go is alpha-quality software. It powers code analysis on but has not been widely tested or adapted for other use cases.


Patches are welcomed via GitHub pull request! See for more information.

srclib-go's type analysis is based on go/types.