These are the currently supported versions of Agda:

• Agda-2.8.0
• Agda-2.7.0.1
• Agda-2.6.4.3

All releases will come with binaries built with these versions of Agda.

We plan to make the codebase compatible with at most 3 versions of Agda at a single time. Because otherwise we'd be drowned by CPP macros for conditional compilation.

The simplest way of acquiring Agda Language Server is through agda-mode on VS Code. Follow the instructions and the language server should be installed within seconds.

You can also download prebuilt binaries from the release page if you are using other LSP-compatible text editors.

Supported platforms: Windows, Mac, and Ubuntu.

For testing the latest features and bug fixes, you can download development pre-releases:

• Stable releases: Tagged as v6, v7, etc. - recommended for general use
• Development releases: Tagged as dev - latest features, may be unstable

Development releases are updated as needed and contain the latest changes from the main branch.

You will need Haskell Stack to build the project:

stack install

Single-digit versioning for the language server itself - people mostly just care about the Agda version it supports anyway.

• for less impact on the Agda codebase
• to help decouple the Agda codebase
• we can always merge it back to Agda later anyway

This language server is co-developed alongside agda-mode on VS Code.

To make development easier, you can host the language server locally at localhost:4096 by running :main -p in the REPL (stack repl).

Add lsp://localhost:4096 to agdaMode.connection.paths in VS Code's settings, then hit C-x C-s to select it as the endpoint.

This allows you to reload the language server in the REPL without recompiling and reinstalling the whole project every time you make changes.

To create a development pre-release, push to the dev branch:

git push origin master:dev

This creates/updates the dev pre-release with artifacts for the latest Agda version on all platforms.