Neovim plugin to solve “What was I doing here” when moving between dirs

It’s for someone who doesn’t need a terminal multiplexer like tmux or zellij but hops in and out of folders with multiple neovim instances and need to place a mental checkpoint in what they were doing or thinking.

I’ve been using Neovim as a daily driver for about 2 years or so now, I’ve tried different package managers, over-configured plugins then went back to a minimal setup. I’ve eventually settled on what was a kickstart.nvim clone to now nvim-config. I don’t really need a terminal multiplexer, I might have k9s, nvim + term in vsplit for exec, one more nvim tab and maybe an ssh session - but not often enough for me to need to learn another set of keybindings so this is a painfully simple solution to tracking intended changes per current working directory but as a Neovim plugin.

Features

• Store intentions per workspace (cwd)
• Persistent storage between Neovim sessions
• Minimal and fast
• Written in pure Lua

Installation

Prerequisites

• Neovim >= 0.8.0
• nvim-lua/plenary.nvim

Using lazy.nvim:

{
  "bxrne/was.nvim",
  dependencies = {
    "nvim-lua/plenary.nvim", -- for path handling
  },
  config = true, -- calls require('was').setup()
},

Using packer.nvim:

use {
  "bxrne/was.nvim",
  requires = {
    "nvim-lua/plenary.nvim", -- for path handling
  },
  config = function()
    require('was').setup()
  end,
}

Configuration

In your Lazy or Packer configuration, you can pass an optional opts table to require('was').setup():

{
  -- "bxrne/was.nvim",
  -- dependencies = {
  --   "nvim-lua/plenary.nvim", -- for path handling
  -- },
  -- config = true, -- calls require('was').setup()
  opts = { -- optional config
    defer_time = 3000, -- default time for window to live for (ms)
  },
}

Usage

Store your current intention:

:Was Implementing user authentication system

View your last stored intention:

:Was

The plugin automatically detects your workspace based on:

1. Git root directory (if in a Git repository)
2. Current working directory (if not in a Git repository)

Intentions are stored persistently in ~/.local/share/nvim/was/intentions.json.

Testing

nvim --headless -c "PlenaryBustedDirectory tests/ { minimal_init = './tests/minimal_init.lua' }"