spacemacs/layers/+tools/prodigy/README.org

63 lines
2.2 KiB
Org Mode

#+TITLE: Prodigy layer
#+TAGS: layer|tool
[[file:img/prodigy.png]]
* Table of Contents :TOC_5_gh:noexport:
- [[#description][Description]]
- [[#features][Features:]]
- [[#install][Install]]
- [[#key-bindings][Key bindings]]
- [[#spawn-prodigy][Spawn prodigy]]
- [[#navigate-through-it][Navigate through it]]
* Description
This layer adds support for the [[https://github.com/rejeep/prodigy.el][prodigy]] package to manage external services from
within Emacs, check the package's documentation for more details.
It is recommended to put your prodigy services in the =dotspacemacs/user-config=
part of your =~/.spacemacs= file.
** Features:
- Managing of pre-declared services from within emacs
- Showing of process output in special buffers
- Filtering of processes for tags or names
* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =prodigy= to the existing =dotspacemacs-configuration-layers= list in this
file.
* Key bindings
** Spawn prodigy
You start prodigy with this:
| Key binding | Description |
|-------------+-------------------------|
| ~SPC a S~ | Open the prodigy buffer |
** Navigate through it
| Key binding | Description |
|-------------+---------------------------------|
| ~c~ | Clear buffer |
| ~h~ | First service |
| ~j~ | Next service |
| ~k~ | Previous service |
| ~l~ | Last service |
| ~H~ | Display current process |
| ~J~ | Next service with status |
| ~K~ | Previous service with status |
| ~L~ | Start prodigy |
| ~S~ | Stop prodigy |
| ~r~ | restart prodigy |
| ~R~ | revert buffer (refresh list) |
| ~d~ | Jump to the dired of service |
| ~g~ | Jump to magit-status of service |
| ~Y~ | Copy prodigy command |
| ~o~ | Browse the service |
| ~f t~ | Add tag filter |
| ~f n~ | Add name filter |
| ~F~ | Clear filters |