Sourcegraph for Raycast

Search code, manage batch changes, and browse notebooks on Sourcegraph with Raycast.

Install · Setup · Commands · Issues · Changelog · Contributing

Install

To get started, install Raycast and install the Sourcegraph extension from the Raycast extensions store.

Alternatively, you can install this extension from source.

Setup

This extension adds a variety of commands for interacting with Sourcegraph. Some configuration is required to use certain features, most notably the variants of each command for custom Sourcegraph Instances, though you can get started with Sourcegraph.com commands without any additional setup.

Sourcegraph.com

No setup is required to connect to Sourcegraph.com through the 'Sourcegraph.com' variants of this extensions's commands. To configure your own search contexts, create search notebooks, and more, sign up for a Sourcegraph.com account!

Once you have an account, you can create an access token under the "Access tokens" tab in your user settings on Sourcegraph.com. Copy that access token to the "Sourcegraph.com: Access token" field in the Sourcegraph Raycast extension preferences to authenticate your search queries.

To search your private code, please reach out get a demo of the single-tenant solution or try out a self-hosted installation of Sourcegraph.

Sourcegraph Instance

To start searching code on a custom Sourcegraph instance (e.g. self-hosted or managed), you can set up access through the 'Sourcegraph Instance' variants of this extensions's commands by configuring the "Sourcegraph Instance: Instance URL" and "Sourcegraph Instance: Access token" fields in the Sourcegraph Raycast extension preferences. You can create an access token under the "Access tokens" tab in your user settings on your Sourcegraph instance.

Commands

Search Code

Get results as you type on code search over your code and many public repositories.

Search contexts

Search contexts allow you to narrow down your search to code you care about. To get started, you can try the public Sourcegraph.com search contexts, or configure your own in your Sourcegraph.com account or Sourcegraph instance's "Contexts" page!

The Sourcegraph Raycast extension allows you to set a default context for your searches in the "Search Code" command preferences.

Code Search History

Browse, manage, and run recent code searches. New searches can also easily be launched from the Code Search History command.

Recent searches are persisted locally through a native Raycast API.

Manage Batch Changes

Browse, view, publish, and merge changesets for batch changes straight from Raycast. Batch changes automate large-scale code changes to keep your code up to date, fix critical security issues, and pay down tech debt across all of your repositories.

Batch changes are currently only supported on Sourcegraph Instance.

Find Search Notebooks

Browse and preview search notebooks straight from Raycast. Notebooks enable powerful live – and persistent – documentation, shareable with your organization or the world.

Notebooks are currently only supported on Sourcegraph Instance.

Changelog

The changelog documents all notable updates to the extension.

Updates will be regularly published to the Raycast Extensions repository from the bobheadxi/raycast-sourcegraph repository. To try out yet-to-be-published changes, you can install this extension from source.

Contributing

See CONTRIBUTING.md if you're interested in contributing to this extension!

Have ideas or suggestions? Please feel free to open an issue with feedback!