sponsor Vim development Vim logo Vim Book Ad

wheel : Buffer group & workspace manager

 script karma  Rating 0/0, Downloaded by 277  Comments, bugs, improvements  Vim wiki

created by
chimay orduval
script type
Wheel ( https://github.com/chimay/wheel ) is a navigation plugin for
Vim and Neovim. It is buffer group oriented and makes abundant use of
special buffers, in which you can filter and select elements.

Wheel let you organize your buffers by creating as many buffer groups as
you need, add the buffers you want to it and quickly navigate between :

- Buffers of the same group
- Buffer groups

Note that :

- A location contains a name, a filename, as well as a line & column number
- A buffer group, in fact a location group, is called a circle
- A set of buffer groups, or a category, is called a torus (a circle of circles)
- The list of toruses is called the wheel

Wheel is designed to follow your workflow : you only add the files
you want, where you want. For instance, if you have a `organize` group
with agenda & todo files, you can quickly alternate them, or display
them in two windows. Then, if you suddenly got an idea to tune vim,
you switch to the `vim` group with your favorites configuration files in
it. Same process, to cycle, alternate or display the files. Over time,
your groups will grow and adapt to your style.


- Add
  + Files from anywhere in the filesystem
  + A file in more than one group
  + file:line-1 and file:line-2 in the same group
- May be saved in wheel file
- Easy navigation
  + On demand loading of files
  + Switch to matching tab & window if available
  + Choose file, group or category in special buffer
    * Filter candidates
    * Folds matching wheel tree structure
    * Context menus
  + Auto |:lcd| to project root of current file
- Search files
  + MRU files not found in wheel
  + Using locate
  + Using find
- Search inside files
  + Grep on group files
  + Outline
    * Folds headers in group files (based on fold markers)
    * Markdown headers
    * Org mode headers
  + Tags
- Yank wheel using TextYankPost event
- Reorganizing elements
- Display files
  + Split levels : torus, circle, location
  + Split
    * vertical, golden vertical
    * horizontal, golden horizontal
    * main left, golden left
    * main top, golden top
    * grid
  + Mix of above
    * circles on tabs, locations on split
    * toruses on tabs, circles on split
- Batch operations
install details
If you use minpac :

call minpac#add('chimay/wheel', { 'type' : 'start' })

With plug :

Plug 'chimay/wheel'

The syntax should be similar with other git oriented plugin managers.

Otherwise, simply add the files to the matching directories in your runtime.

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
wheel-1.20.tar.gz 1.20 2021-04-22 8.0 chimay orduval - improved selections in dedicated buffers : select/clear/toggle all visible, filtered lines
- generalisation of buffer layers
- ability to reload a dedicated buffer
- easy navigation between dedicated buffers & layers : switch, back and forth
wheel-1.15.tar.gz 1.15 2021-04-10 8.0 chimay orduval New features :

edit mode for grep
async commands
add files using glob
characterwise / linewise paste from yank wheel
reorganize tabs & window from special buffer
wheel-1.10.tar.gz 1.10 2021-03-15 7.0 chimay orduval autogroup files by extensions or directories
wheel.tar.xz 1.5 2020-04-25 8.0 chimay orduval quick navigation framework, context menus, tags, folds in main menu, find with async job
wheel.tar.xz 1.0 2020-04-12 8.0 chimay orduval Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.