Skip to content

KarimAziev/counsel-extra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About

An Emacs library that extends the functionality of the ivy and counsel packages by providing extra utilities and commands.

Table of Contents

Requirements

NameVersion
Emacs27.1
ivy0.13.4
counsel0.13.4

Installation

The package requires Emacs 27.1 or later, as well as the ivy and counsel packages (version 0.13.4 or later).

With use-package and straight.el

(use-package counsel-extra
  :straight (:repo "KarimAziev/counsel-extra"
                   :type git
                   :host github)
  :hook ((ivy-mode . counsel-extra-add-extra-actions)
         (counsel-mode . counsel-extra-configure-find-file))
  :bind ((:map counsel-extra-M-x-keymap
               ("C-c o" . counsel-extra-M-X-find-symbol-in-other-window-cmd))
         (:map counsel-extra-bookmark-map
               ("C-c o" . counsel-extra-bookmark-in-other-window))))

Manual installation

Download the source code and put it wherever you like, e.g. into ~/.emacs.d/counsel-extra/

git clone https://github.com/KarimAziev/counsel-extra.git ~/.emacs.d/counsel-extra/

Add the downloaded directory to the load path:

(add-to-list 'load-path "~/.emacs.d/counsel-extra/")
(require 'counsel-extra)

Usage

Extended commands

These commands are expected to be bound in the counsel-mode-map.

“` </details>

  • counsel-extra-M-x - Extra version of execute-extended-command.
  • counsel-extra-list-processes - Offer completion for process-list. The default action is to switch to the process buffer. An extra action allows to delete the selected process.
  • counsel-extra-colors-emacs - Show a list of all supported colors for a particular frame. Unlike `counsel-colors-emacs’ it is allows to define extra commands in it’s keymap - `counsel-extra-emacs-colors-map’.

File commands

These commands are expected to be bound in the counsel-find-file-map.

  • M-x counsel-extra-open-file-other-window - Quit the minibuffer and call find-file-other-window action.
  • M-x counsel-extra-move-file - Quit the minibuffer and call counsel-find-file-move action.
  • M-x counsel-extra-delete-file - Quit the minibuffer and call counsel-find-file-delete action.
  • M-x counsel-extra-copy-file - Quit the minibuffer and call counsel-find-file-copy action.
  • M-x counsel-extra-dired - Open file in Dired.
  • M-x counsel-extra-expand-dir-done - Visit or preview currently selected directory or file. If it is a valid directory, visit it and stay in minibuffer, otervise

execute default ivy action and exit minibuffer.

  • M-x counsel-extra-expand-dir-maybe - Visit or preview currently selected directory or file and stay in minibuffer. If it is not a valid directory, preview the file.

Imenu commands

These commands are expected to be bound in the counsel-imenu-map.

  • M-x counsel-extra-imenu-insert-cmd - Quit the minibuffer and insert imenu item.
  • M-x counsel-extra-imenu-jump-to-item-in-other-window - Jump to imenu item in other window

Describe commands

This command is supposed to be bound to counsel-describe-map.

  • M-x counsel-extra-find-symbol-in-other-window - find symbol in other window and exit minibuffer.

Bookmark commands

  • M-x counsel-extra-bookmark - Forward to bookmark-jump or bookmark-set if the bookmark doesn’t exist.
  • M-x counsel-extra-bookmark-in-other-window - Open bookmark in another window.

Misc commands

These commands are expected to be bound in the ivy-minibuffer-map.

Customization

counsel-extra-align-M-x-description

Whether to align command descriptions. If nil, don’t align, if integer align to those column.

About

Commands and utils for ivy and counsel.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published