Warning
Onoma and all of its editor integrations are still in early development. Expect bugs, breaking changes, and other general hiccups.
ὄνομα — Onoma (pronounced
OH-no-ma) is Greek for “name”, signifying not just a label, but the essence or character of a thing.
Onoma.nvim is a Neovim plugin built around Onoma, the fast, language-agnostic semantic symbol indexer and fuzzy finder, which doesn't require a full language server or limit workspace-wide searches.
It provides a first-class integration into Neovim, using Snacks Picker, Telescope or mini.pick as the frontend for fuzzy finding semantic symbols in source code.
- Rust (
.rs) - Go (
.go) - Lua (
.lua) - Clojure (
.clj) - TypeScript (
.tsand.tsx) / JavaScript (.jsand.jsx) - Python (
.py)
540262784-6df459ec-e97d-4b95-8a97-11fb7aacecaf.mov
Tip
Run :checkhealth onoma to validate Onoma is set up correctly.
Snacks
return {
'ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
-- Otherwise, you can build from source
-- build = 'cargo --config ./bridge/.cargo/config.toml build --release --manifest-path ./bridge/Cargo.toml'
dependencies = {
'folke/snacks.nvim',
},
event = 'VeryLazy',
config = function()
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'snacks' },
})
vim.keymap.set({ 'n', 'v', 'x' }, 'fs', Snacks.picker.get_symbols, { desc = 'Symbols', silent = true })
end,
}Telescope
return {
'ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
-- Otherwise, you can build from source
-- build = 'cargo --config ./bridge/.cargo/config.toml build --release --manifest-path ./bridge/Cargo.toml'
dependencies = {
'nvim-telescope/telescope.nvim',
},
event = 'VeryLazy',
config = function()
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'telescope' },
})
vim.keymap.set(
{ 'n', 'v', 'x' },
'fs',
require('telescope').extensions.onoma.get_symbols,
{ desc = 'Symbols', silent = true }
)
end,
}Mini.Pick
return {
'ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
-- Otherwise, you can build from source
-- build = 'cargo --config ./bridge/.cargo/config.toml build --release --manifest-path ./bridge/Cargo.toml'
dependencies = {
{ 'nvim-mini/mini.pick', version = '*' },
},
event = 'VeryLazy',
config = function()
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'mini' },
})
vim.keymap.set({ 'n', 'v', 'x' }, 'fs', MiniPick.registry.get_symbols, { desc = 'Symbols', silent = true })
end,
}Snacks
vim.api.nvim_create_autocmd('PackChanged', {
callback = function(ev)
local name, kind = ev.data.spec.name, ev.data.kind
if name == 'onoma.nvim' and (kind == 'install' or kind == 'update') then
if not ev.data.active then
vim.cmd.packadd('onoma.nvim')
end
require('onoma').build():await()
end
end,
})
vim.pack.add({
'folke/snacks.nvim',
{
src = 'https://github.com/ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
},
})
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'snacks' },
})
vim.keymap.set({ 'n', 'v', 'x' }, 'fs', Snacks.picker.get_symbols, {
desc = 'Symbols',
silent = true,
})Telescope
vim.api.nvim_create_autocmd('PackChanged', {
callback = function(ev)
local name, kind = ev.data.spec.name, ev.data.kind
if name == 'onoma.nvim' and (kind == 'install' or kind == 'update') then
if not ev.data.active then
vim.cmd.packadd('onoma.nvim')
end
require('onoma').build():await()
end
end,
})
vim.pack.add({
'nvim-telescope/telescope.nvim',
{
src = 'https://github.com/ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
},
})
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'telescope' },
})
vim.keymap.set(
{ 'n', 'v', 'x' },
'fs',
require('telescope').extensions.onoma.get_symbols,
{ desc = 'Symbols', silent = true }
)Mini.Pick
vim.api.nvim_create_autocmd('PackChanged', {
callback = function(ev)
local name, kind = ev.data.spec.name, ev.data.kind
if name == 'onoma.nvim' and (kind == 'install' or kind == 'update') then
if not ev.data.active then
vim.cmd.packadd('onoma.nvim')
end
require('onoma').build():await()
end
end,
})
vim.pack.add({
{ 'nvim-mini/mini.pick', version = '*' },
{
src = 'https://github.com/ryanmab/onoma.nvim',
version = '*', -- Required for stable releases (recommended)
-- Or, you can use the nightly builds
-- tag = 'nightly',
},
})
require('onoma').setup({
-- Default configuration can be found in: "lua/config.lua"
picker = { 'mini' },
})
vim.keymap.set({ 'n', 'v', 'x' }, 'fs', MiniPick.registry.get_symbols, { desc = 'Symbols', silent = true }):Onoma update- Update and validate build.:Onoma run_full_index- Re-index the whole workspace.:Onoma health(or:checkhealth onoma) - Run health checks.
Contributions are welcome!
The core Onoma backend contains all editor-agnostic functionality, including improvements to indexing and fuzzy matching.
For editor-specific features or changes to bindings for a particular editor, please submit pull requests in the respective editor repositories.
- fff.nvim for inspiring the semantic fuzzy finder design in Onoma.
- snacks.nvim for the excellent picker frontend.
- telescope.nvim for the excellent picker frontend.
- mini.nvim for the excellent picker frontend.
- frizbee for the high-performance SIMD implementation of fuzzy matching.