presence.nvim

💓 presence.nvim is an open-source Neovim plugin that broadcasts your editor activity to the web in real-time — Inspired by cord.nvim.

Liven up your portfolio by adding a simple api to display your nvim status!!

Live Demo

If you missed me heres a photo to demo!

📦 Installation

Note

presence.nvim will automatically load with defaults; calling setup() is optional.

Lazy

{
    'cjodo/presence.nvim'
}

⚙️ Configuring

{
    'cjodo/presence.nvim',
    config = function()
        -- defaults
        require("presence").setup({
            autostart = true,
            endpoints = { "http://localhost:3000/presence" },
            user = "anonymous",
            token = nil,
            heartbeat_interval = 5, 
            enabled = true,

        })
    end
}

Exaple POST

{
  "project": "presence.nvim",
  "user": "User",
  "updated_at": 1770584360,
  "session": "de545b3ccee713656f80e3ad18e6b61a6c1fd15d3938c56ec740a4a473ec31e5",
  "filetype": "markdown",
  "status": "online",
  "file": "README.md",
  "cwd": "/home/user/full/path",
  "mode": "i",
  "received_at": "2026-02-08T20:59:38.049Z"
}

• make sure to check out the examples/

Development

For a look at the state being sent to your endpoints make sure to include localhost:3000/presence in your config.

• go to the dev server

cd server
npm install 
node index.js

you can visit your browser http://localhost:3000/presence to see whats happening