Home - corigne/swank.nvim GitHub Wiki

swank.nvim Wiki

Pure-Lua Neovim-native Common Lisp development via the Swank protocol.

Contents

Page Description
Features Full feature list and roadmap
Architecture How the layers fit together; async model; event dispatch
Configuration Full setup() option reference
Completions blink.cmp, nvim-cmp, and omnifunc setup
Keybindings Default keymaps, LSP-compatible overrides, customisation
REPL REPL usage, window layout, auto-open behaviour
Protocol Swank S-expression framing internals (for contributors)
Contributing Coverage floor, test placement, code style
Testing Test infrastructure, how to run tests, writing new tests

Quick start

1. Install

{
  "corigne/swank.nvim",
  ft   = { "lisp", "commonlisp" },
  opts = {},
}

2. Open a Lisp file

Open any .lisp or .cl file. swank.nvim spawns SBCL and connects automatically. The REPL appears as soon as the server is ready.

To connect to an already-running Swank server instead (e.g. on a remote host), disable autostart and use <Leader>lc to connect manually.

⚠️ **GitHub.com Fallback** ⚠️