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

#+TITLE: Prodigy layer

[[file:img/prodigy.png]]

* Table of Contents                                         :TOC_4_gh:noexport:
 - [[#description][Description]]
 - [[#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.

* 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                     |
|-------------+---------------------------------|
| ~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                   |