Forge — Neovim integration
Forge no longer includes a GTD task system. If you use a Neovim plugin to integrate with Forge, keep it focused on kanban + Finder-tag project management commands.
File: ~/.config/nvim/lua/plugins/forge-nvim.lua
Dependencies
| Plugin | Role |
|---|---|
| toggleterm.nvim | Terminal panes for CLI output |
| telescope.nvim | Fuzzy file browsing and grep within your project roots |
| which-key.nvim | Displays <leader>F group in the keymap popup |
| mini.starter | Dashboard section with Forge shortcuts |
All dependencies should be optional (pcall) so the plugin degrades gracefully.
Suggested keymaps
All keymaps use the <leader>F prefix (normal mode).
View commands
Read-only output in a terminal pane. Press q to close.
| Key | Command | Description |
|---|---|---|
<leader>Fb |
forge board --list |
Kanban board (list view) |
<leader>Ft |
forge status |
Project summary dashboard |
<leader>Fc |
forge calendar |
Upcoming Calendar events |
Project maintenance
| Key | Command | Description |
|---|---|---|
<leader>Fm |
forge move |
Move a project to a column (interactive args in terminal) |
<leader>Ftg |
forge project-tag |
Add/remove/list Finder tags on a project folder |
Commands
If you expose Neovim commands, these cover the kanban-only surface area:
| Command | Description |
|---|---|
:ForgeBoard |
Show kanban board |
:ForgeStatus |
Show project status dashboard |
:ForgeCalendar |
Show upcoming events |
:ForgeMove |
Move a project between columns |
:ForgeProjectTag |
Add/remove/list project tags |
:ForgeSetup |
Build and install Forge on this Mac (runs build.sh) |