Jerry's dev blog
홈으로 돌아가기

sidekick.nvim - Copilot Next Edit Suggestion 과 AI CLI 사용하기

2025년 10월 6일 • 7분 읽기
NeovimPlugin

안녕하세요, 오늘은 sidekick.nvim 이라는 플러그인을 간단히 소개해드리려고 합니다.

sidekick 플러그인은 크게 2가지 기능을 제공합니다.

  1. Copilot LSP 위에서 동작하는 NES(Next Edit Suggestion)
  2. Neovim 에디터와 CLI Agent(Claude, Codex, Copilot, ...) 의 통합

하나씩 알아보도록 하겠습니다.

1. Next Edit Suggestion(NES)

Cursor Editor를 사용해보셨다면 Tab 기능을 아주 유용하게 활용하셨을텐데요, Neovim 에도 이제 비슷한 기능을 사용할 수 있게 되었습니다.

바로 Language Server Protocol(LSP) 기반으로 동작하는 Next Edit Suggestion(NES) 기능인데, 코드를 작성하는 동안 다음에 편집할 위치를 예측하고 제안하는 기능을 말합니다.

아래 gif 를 보시면 Tab 키를 통해 다음 코드 제안 위치로 이동하고 suggestion을 accept 할 수 있으며, 변경할 코드의 diff 가 표시되는 것을 확인할 수 있습니다.

nes

자동완성의 발달과 Next Edit Suggestion

자동완성은 대략적으로 tradtional completion -> inline completion -> next edit suggestion 단계로 발전하고 있습니다.

전통적인 자동완성(traditional completion) 은 사용자가 코드를 작성하면 현재 커서 위치에서 작성 가능한 코드 조각을 제안하는 방식이었습니다. LSP 서버는 단순히 AST를 분석하여 현재 문맥에 맞는 코드 조각을 제안하고, 사용자는 팝업 메뉴에서 원하는 코드를 선택하여 코드를 완성했습니다.

LLM 이 등장한 이후 자동완성은 copilot 과 같은 도구를 통해 현재 작성하는 코드의 문맥을 LLM 모델로 실시간으로 분석하여 이어서 작성할 코드를 제안하는 inline completion 방식으로 발전했습니다. 보통 ghost text로 표시되어 inline completion 이라고 불리며, 사용자의 패턴을 학습하여 더 나은 제안을 제공할 수 있습니다.

next edit suggestion은 inline completion 에서 더 나아가, 사용자가 작성한 코드의 변경 사항을 분석하여 그 다음에 편집할 위치를 예측하고 제안합니다. 예를 들면, 어떤 함수 이름을 변경하면 그 함수가 호출되는 모든 위치를 찾아서 함께 변경할 것을 제안하는 식입니다.

결론적으로 sidekick의 NES 기능은 Copilot LSP 위에서 동작하므로, copilot-lsp-server 가 설치되어 있어야 합니다. copilot lsp 는 npm 으로 설치하거나, Mason 을 사용하신다면 Mason 으로 설치하시면 됩니다.

bash
npm install -g @github/copilot-language-server
lua
vim.lsp.config('copilot', {
  cmd = {
    "copilot-language-server",
    "--stdio",
  },
  settings = {
    telemetry = {
      telemetryLevel = "all",
    },
  },
  -- copy sign in/out method from https://github.com/neovim/nvim-lspconfig
  on_attach = function(client, bufnr)
    vim.api.nvim_buf_create_user_command(bufnr, "LspCopilotSignIn", function()
      sign_in(bufnr, client)
    end, { desc = "Sign in Copilot with GitHub" })

    vim.api.nvim_buf_create_user_command(bufnr, "LspCopilotSignOut", function()
      sign_out(bufnr, client)
    end, { desc = "Sign out Copilot with GitHub" })
  end,
})

-- Copilot LSP 활성화
vim.lsp.enable({ 'copilot' })

2. CLI Agent integration in Neovim

sidekick.nvim 은 NES 기능에 더불어 Neovim에 CLI Agent 를 통합할 수 있는 기능을 제공합니다. Claude, Codex, Copilot 등 다양한 AI 모델을 CLI로 활용할 수 있는데요, 한 번 Claude CLI를 활용하는 예시를 보여드리겠습니다.

cli

Neovim 에디터 안에서 CLI 터미널을 사용하기 위해 꼭 있어야 된다고 생각했던 기능은 바로 CLI 세션 유지인데요, 개발하다보면 에디터를 재시작해야할 때가 종종 있는데 이 때 세션이 유지되지 않으면 곤란하겠죠.

다행히도 sidekick 에서는 tmux 나 zellij 같은 도구를 사용하여 Neovim이 종료되어도 CLI 세션이 유지되도록 할 수 있습니다. 기존에 있던 다른 CLI Agent 통합 플러그인도 세션 유지 기능을 지원하는지 모르겠는데, sidekick은 기본적으로 지원해주니 매우 편리합니다.

lua
cli = {
  mux = {
    backend = "tmux",
    enabled = true,
  },
}

또한 다양한 AI 모델을 지원하니, Neovim 창 안에서 한 에이전트의 세션을 유지하면서도 다른 에이전트로 자유롭게 바꿔가며 작업하기에 매우 유용할 것 같습니다.

마무리

이렇게 간단하게 sidekick.nvim 플러그인에 대해 알아보았는데요, 아직 Neovim 0.12 버전이 정식 릴리즈 된 것도 아니고 sidekick.nvim 도 공개된지 얼마 되지 않았기 때문에 Neovim 0.12 가 정식 릴리즈 될 즈음에는 더 완성도 있는 플러그인이 되어있지 않을까 싶습니다.

또한 CLI 기능은 0.12 버전이 아니어도 활용할 수 있으니, 정식 릴리즈 전에 버전을 올리고 싶지 않은데 CLI 기능을 활용해 보고 싶은 분들은 한 번 사용해보시는 것도 좋을 것 같습니다!