https://github.com/1riz/telescope-macros.nvim
telescope.nvim extension to manage macros (WIP)
https://github.com/1riz/telescope-macros.nvim
lua macros neovim nvim nvim-plugin registers telescope-extension
Last synced: 4 months ago
JSON representation
telescope.nvim extension to manage macros (WIP)
- Host: GitHub
- URL: https://github.com/1riz/telescope-macros.nvim
- Owner: 1riz
- License: mit
- Created: 2023-10-19T17:26:25.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-08-03T17:13:31.000Z (11 months ago)
- Last Synced: 2025-08-03T19:08:09.286Z (11 months ago)
- Topics: lua, macros, neovim, nvim, nvim-plugin, registers, telescope-extension
- Language: Lua
- Homepage:
- Size: 14.6 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# telescope-macros.nvim
[](https://github.com/1riz/telescope-macros.nvim/actions/workflows/main.yml)
An extension for [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)
that allows you to manage your macros.

:warning: **This plugins is under development.**
## Requirements
- [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)
## Installation
### [Lazy.nvim](https://github.com/folke/lazy.nvim)
```lua
{
"1riz/telescope-macros.nvim",
config = function()
require("telescope").load_extension "macros"
end
}
```
## Usage
```vim
:Telescope macros
```
or map to a key:
```lua
vim.keymap.set("n", "m", "Telescope macros")
```
## Default mappings (normal and insert mode):
| Key | Description |
| ------- | ----------------------------------- |
| `` | execute macro |
| `` | edit macro |
| `` | append comment |
| `` | clear macro |
| `` | clear all macros |
| `` | delete macro |
| `` | delete all macros |
## Configuration
See [setup structure](https://github.com/nvim-telescope/telescope.nvim#telescope-setup-structure) for full details on configuring Telescope pickers.
- `prompt_title` (default: `"Macros"`)
Defines the title of the prompt window.
- `num_registers` (default: `12`)
Number of registers to be managed by this extension.
### Default configuration
```lua
telescope.setup {
extensions = {
macros = {
prompt_title = "Macros",
num_registers = 12,
theme = "dropdown",
layout_strategy = "center",
layout_config = {
height = 0.20,
width = 0.50
}
}
}
}
```