A Neovim plugin for fast, structured debug logging in JavaScript and TypeScript.

rocketlog.nvim helps you insert consistent console.* statements, keep embedded file/line labels fresh as code moves, and manage existing logs from a purpose-built dashboard instead of hunting through files like a raccoon in a cable drawer.

• Operator-pending log insertion for motions and text objects
• Word-under-cursor logging when you just need a quick probe
• Consistent console.log / warn / error / info output
• Automatic label refresh on insert and save
• Safety guardrails for unsafe insertion contexts
• Delete helpers for next, previous, or all logs in a buffer
• Project log picker via snacks.nvim
• RocketLog Dashboard for previewing, filtering, folding, toggling, refreshing, and opening logs
• Built-in dashboard footer cheatsheet plus a dedicated help modal on ?

console.log(`🚀[ROCKETLOG] ~ user.ts:42 ~ account:`, account);
console.warn(`🚀[ROCKETLOG] ~ user.ts:42 ~ account:`, account);
console.error(`🚀[ROCKETLOG] ~ user.ts:42 ~ account:`, account);
console.info(`🚀[ROCKETLOG] ~ user.ts:42 ~ account:`, account);

const fullName = user.profile.name;

const fullName = user.profile.name;
console.log(`🚀[ROCKETLOG] ~ user.ts:2 ~ fullName:`, fullName);

Media placeholder — hero GIF

Add a short GIF here showing:

1. opening a TypeScript file,
2. inserting a log with <leader>rL,
3. saving the file,
4. opening the dashboard with <leader>rr,
5. pressing ? to open the help modal.

Suggested filename: docs/assets/hero-overview.gif

This gives you the full experience, including the picker command.

{
  "evanmcpheron/rocketlog.nvim",
  dependencies = {
    "nvim-treesitter/nvim-treesitter",
    "folke/snacks.nvim",
  },
  config = function()
    require("rocketlog").setup()
  end,
}

If you do not care about the picker, snacks.nvim is not required. The plugin will still work, and :RocketLogFind will simply warn if snacks.nvim is unavailable.

{
  "evanmcpheron/rocketlog.nvim",
  dependencies = {
    "nvim-treesitter/nvim-treesitter",
  },
  config = function()
    require("rocketlog").setup()
  end,
}

By default, plugin/rocketlog.lua calls require("rocketlog").setup() automatically.

If you want full control over when setup runs:

vim.g.rocketlog_disable_auto_setup = true
require("rocketlog").setup()

1. Install the plugin.
2. Open a JavaScript or TypeScript file.
3. Put your cursor on a variable and press <leader>rL.
4. Or use <leader>rl followed by a motion or text object, like iw.
5. Open the dashboard with <leader>rr.
6. Use c to toggle a selected log on or off, d to delete it, or <CR> to jump to it.
7. Press ? inside the dashboard any time you want the full help modal.

For the full walkthrough, see Getting started.

For examples using motions like iw, a{, and more, see Usage.

The dashboard is the plugin’s command center. It groups logs by file, shows a preview pane, keeps an always-visible footer cheatsheet on screen, and opens a dedicated help modal on ? when you want the full keybinding reference without leaving the UI.

See Dashboard guide for the full walkthrough.

require("rocketlog").setup({
  keymaps = {
    motions = "<leader>rl",
    word = "<leader>rL",
    error_motions = "<leader>re",
    error_word = "<leader>rE",
    warn_motions = "<leader>rw",
    warn_word = "<leader>rW",
    info_motions = "<leader>ri",
    info_word = "<leader>rI",
    delete_below = "<leader>rd",
    delete_above = "<leader>rD",
    delete_all_buffer = "<leader>ra",
    find = "<leader>rf",
    dashboard = "<leader>rr",
  },

  label = "ROCKETLOG",
  enabled = true,
  refresh_on_save = true,
  refresh_on_insert = true,
  prefer_treesitter = true,
  fallback_to_heuristics = true,

  allowed_filetypes = {
    javascript = true,
    javascriptreact = true,
    typescript = true,
    typescriptreact = true,
  },

  dashboard = {
    width = 0.96,
    height = 0.92,
    preview_context = 4,
    max_files = 2000,
    excluded_dirs = {
      ".git",
      "node_modules",
      "dist",
      "build",
      "coverage",
      ".next",
      ".turbo",
    },
  },
})

For a full option-by-option breakdown, see Configuration reference.

• JavaScript and TypeScript are the default supported target filetypes.
• Tree-sitter is strongly recommended for safer insertion behavior.
• The plugin can fall back to heuristics when Tree-sitter is unavailable.
• The dashboard prefers live buffer contents for open files and scans project files for everything else.
• If rg is installed, the dashboard uses it to narrow project scans before parsing files.
• :RocketLogFind depends on snacks.nvim.

• Start with Troubleshooting
• Open an issue
• Read Contributing before opening a PR

MIT