# Tick (CHICKEN's Bug Tracker)

## Environment variables

* `TICK_CONF_DIR` (string, default=`$HOME/.config/tick`): Configuration
  directory.

* `TICK_CACHE_DIR` (string, default=`$HOME/.cache/tick`): Directory
  where tick's cache will be stored, including the the git repository
  of tickets (`db` directory) will be cloned into.

* `TICK_LOG_LEVEL` (positive integer, default=`30`): Log level (see the
  documentation of the simple-logger egg)

* `TICK_SERVER_URL` (string, default=`https://code.call-cc.org/tick/`):
  URL to the remote TICK git repository.

* `EDITOR` (editor, default=`emacs`): Editor that will be called to
  compose/edit tickets.

* `TICK_PAGER`, `PAGER`: Pager to use to paginate output on the
  terminal.

## Configuration file

tick will read a `conf.scm` file from the directory pointed by the
`TICK_CONF_DIR` environment variable (falling back to
`$HOME/.config/tick`). If `conf.scm` doesn't exist, tick will use its
defaults.

The configuration file can be used to configure tick parameters (see
`tick-params.scm`), define named queries (see `tick query -h`) and/or
extend tick's command line interface through the definition of custom
commands.

Example:

```
(import tick commands)

(define-named-query 'for-c6
  '(= milestone "6.0.0"))

(define-command 'hello
  "Hello's help message"
  (lambda (args)
    (print "Hello " (if (null? args) "world" args))))
```