Copilot is a Nova integration with Github Copilot Language Server

Supported syntaxes

actionscript, ada, amber, apacheconfig, applescript, asciidoc, assembly, bash, batch, c, clojure, cmake, cobol, coffeescript, cpp, crystal, csharp, css, csv, d, dart, diff, dockerfile, elixir, elm, erlang, fish, fortran, gitconfig, gitignore, go, gradle, graphql, groovy, haskell, haxe, hjson, html, html+ejs, html+erb, ini, java, javascript, json, json5, julia, kotlin, latex, less, lisp, log, lua, make, makefile, markdown, matlab, mediawiki, mysql, nginxconfig, nim, objective-c, objective-cpp, ocaml, orgmode, pascal, perl, php, plaintext, plsql, postgresql, powershell, prolog, properties, protobuf, python, r, regex, restructuredtext, ruby, rust, sass, scala, scheme, scss, shellscript, smalltalk, sqlite, sql, sshconfig, strings, stylus, svelte, swift, tcl, textile, thrift, toml, tsq, tsql, tsx, typescript, vbnet, verilog, vhdl, vue, xml, yaml, zig, zsh

Requirements

Copilot extension requires some additional tools to be installed:

• Node.js
• Copilot Language Server

Install Node.js

Using Homebrew

brew install node

Using Mise

mise install node

Using official site

• Go to https://nodejs.org
• Click "Download Node.js (LTS)" button to download the .pkg installer
• Double-click the .pkg installer to begin installation.

Check installation

$ node -v
v22.13.1

$ npm -v
10.9.2

Install Copilot Language Server

npm install @github/copilot-language-server

Check installation

$ copilot-language-server --version
1.267.0

Configuration

Once Node and Copilot Language Server are installed we need to set the correct paths in extension settings

Open Extensions > Extension Library > Copilot then select Copilot's Settings tab.

In the Node Path field paste the node path. In the Copilot Language Server path paste the copilot-language-server path.

Paths can be found using which command

$ which node
/Users/besya/.local/share/mise/installs/node/22.13.1/bin/node

$ copilot-language-server
/Users/besya/.local/share/mise/installs/node/22.13.1/bin/copilot-language-server

Usage

Sign in

1. Go to Extensions > Copilot > Sign In
2. Notification should appear with the code
3. Copy the code and click "Sign in with Github"
4. Switch to your browser and you should see the Github's Device Activation page
5. Click "Continue"
6. Paste the code you copied earlier
7. Click "Continue"
8. Click "Authorize Github Copilot Plugin"
9. You should see the page with "Congratulations, you're all set!" message
10. Close this page and switch back to Nova
11. Wait a few seconds and the Notification should appear with the "Authorized" message
12. Congratulations. Now you are able to use Copilot

Completions

Default shortcut for inline completion command is ^" (control-shift-') The completion provided by copilot-language-server should appear next to your cursor position and autoselected.

Experimental feature

There is a another option to use inline completion and it's a completion by typing. This invocation happens on TextEditor.onDidStopChanging.

This mode can be enabled in Extensions > Extension Library > Copilot > Settings by enabling the Enable inline completions on typing checkbox.

WARNING: This is an experimental feature, so be careful not to lose or break your code by using it.

Issues

If you encounter issues related to an extension work after updating an extension, copilot-language-server, node, Nova or expired session of Github/Copilot servers you could try to solve them by following these steps:

1. Sign out (Extensions -> Copilot -> Sign Out)
2. Disable Copilot extension (Extensions -> Extension Library... and uncheck the Copilot from Installed Extensions left sidebar)
3. Double-check "Node path" and "Copilot Language Server Path" on the Copilot extension settings page (Extensions -> Extension Library... -> Copilot -> Settings)
4. Quit and reopen Nova
5. Open your project
6. Enable Copilot extension and close extensions window
7. Sign in (Extensions -> Copilot -> Sign In)
8. At this point the Notification with a Github code should appear

If you still have an issue, don't hesitate to https://github.com/besya/nova-copilot/issues/new it

Development

1. Clone repo

   git clone https://github.com/besya/nova-copilot.git

2. Navigate to project folder

   cd nova-copilot

3. Install dependencies

   npm install

4. Run watch

   npm run watch

5. Enable extension

   Extensions > Activate Project as Extension

NPM commands

Clean (cleans copilot.novaextension/Scripts directory)

npm run clean

Build (builds src to copilot.novaextension/Scripts)

npm run build

Watch (rebuilds src to copilot.novaextension/Scripts on src change)

npm run watch