Configuration

Onyo configuration options can be set locally using git config or tracked in the repository using onyo config.

  • git config should be used for preferences of only local relevance, such as onyo.core.editor.

  • onyo config stores values in .onyo/config which is tracked in the repository. These settings are shared with all consumers of an Onyo repository, making it useful for configuration related to common workflows, such as onyo.new.template.

Within the Onyo code, configuration options are read in the following order of precedence:

  1. git config (which follows git’s own order of precedence: system, global, and repository local configuration files)

  2. onyo config

Options

onyo.core.editor

The editor to use for commands such as edit and new. If unset, it will fallback to the environmental variable EDITOR and lastly nano. (default: unset)

onyo.history.interactive

The command used to display history when running onyo history. (default: “tig –follow”)

onyo.history.non-interactive

The command used to print history when running onyo history with --non-interactive. (default: “git –no-pager log –follow”)

onyo.new.template

The default template to use with onyo new. (default: “standard”)