Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
84 lines (52 sloc) 2.64 KB
*unite* or *unite.vim* searches and displays information from arbitrary sources like files,
buffers, recently used files or registers. You can run one of defined action
on a target displayed.
The differences between |unite| and similar plugins like |fuzzyfinder| or |ku|
are that |unite| doesn't use the built-in completion interface of Vim, and
integrates sources at the same time.
In case when you run with files and buffers as the source
:Unite file buffer
In case when you run with the initial input value foo
:Unite -input=foo file
The unite you started splits the window horizontally as default, opening on
the top of the Vim. For example,
:Unite file
lists up the files of the current directory. You may choose one of the
candidates by moving j or k, and typing Enter opens the candidate in a new
buffer. That's the default action for candidates of which kind is file. You
may also select an action with <Tab> on a candidate. See also |unite-action|
about the actions.
You can narrow down the candidates with a keyword. After opening a unite
window, the cursor goes on the right side of > in the 2nd line by typing i.
Then you can input a keyword to narrow down the candidates. Each single
characters you type narrows down the candidates. You also can use a wild
card * as an arbitrary character sequence. For example
matches hisa, ujihisa, or ujihisahisa. Furthermore, two consequence wild cards
matches directory recursively. For example
matches bar/foo or buzz/bar/foo. Note that you should consider using
|file_rec| that will be described bellow in most cases.
You may specify multiple keywords to narrow down, separating by spaces.
foo bar
That matches candidates that match both foo and bar.
You may specify negative conditions with !.
foo !bar
That matches foo but candidates that match bar will be rejected.
You may add wild cards automatically with / if you specify files on
-buffer-name option. That's handy in case you select file with unite.
:Unite -buffer-name=files file
See also |unite_default_key_mappings| for other actions.
Screencast is available. Thanks ujihisa!
install details:
Install the distributed files into Vim script directory which is usually
~/.vim/, or $HOME/vimfiles on Windows.
In future VimJolts the Vim plugin package manager will support unite, you can
install unite just by `jolt install unite`.
You may run unite with |:Unite| command with source as parameters if you
succeeded in installing unite. However, it's pain in ass to run the command
explicitly every time, so I recommend you to set a key mapping for the
Jump to Line
Something went wrong with that request. Please try again.