Skip to content

About

A plugin to integrate Onoma natively into Neovim, enabling fast, typo-resistant, language-agnostic symbol search with fuzzy finding in pickers.

Resources

Stars

15 stars

Watchers

0 watching

Forks

Latest commit

 

History

299 Commits

Folders and files

Repository files navigation

Build GitHub License

Warning

Onoma and all of its editor integrations are still in early development. Expect bugs, breaking changes, and other general hiccups.

Onoma.nvim

ὄνομα — 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.

Supported Languages

  • Rust (.rs)
  • Go (.go)
  • Lua (.lua)
  • Clojure (.clj)
  • TypeScript (.ts and .tsx) / JavaScript (.js and .jsx)
  • Python (.py)

Demo

540262784-6df459ec-e97d-4b95-8a97-11fb7aacecaf.mov

Installation

Tip

Run :checkhealth onoma to validate Onoma is set up correctly.

Lazy.nvim

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,
}

vim.pack

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 })

User Commands

  • :Onoma update - Update and validate build.
  • :Onoma run_full_index - Re-index the whole workspace.
  • :Onoma health (or :checkhealth onoma) - Run health checks.

Contributing

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.

Acknowledgments

  • 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.

About

A plugin to integrate Onoma natively into Neovim, enabling fast, typo-resistant, language-agnostic symbol search with fuzzy finding in pickers.

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages