runit-user-services/README.md

# runit user service files

Various runit service files for per-user services. May need to be modified to work on your system.

Helper scripts:
- `log`: symlink as the `run` script in your service's log directory to enable
  logging to `$SVLOGDIR`. If unset, defaults to `~/.local/log/`
- `utils/setup-supervise.zsh`: run to create symlinks for `supervise`
  directories, so they are created in $XDG_RUNTIME_DIR
- `utils/new-service`: create a new service, executing the given command line.
  Accepted options before service name:

    - `-l`, `--log`: create a log directory and symlink `log` script
    - `-i PROC`, `--import-env PROC`: include import-env script and import environment from process `PROC`

  Example
  ```sh
  utils/new-service -l my-daemon --foreground -a -b -c
  ```
- `utils/svlogs`: like svlogtail for user services. ZSH completion file available in
  `utils/completions`