# [logs]

<!-- Generated by web/apps/docs/scripts/gen-reference.ts from the Atuin source. Do not edit. -->

Atuin's log files.

## `logs.enabled`

Write log files.

- **Type:** boolean
- **Default:** `true`

## `logs.dir`

The directory that log files go in.

- **Type:** string
- **Default:** `"~/.atuin/logs"`

## `logs.level`

The least severe level that logs record. The `ATUIN_LOG` environment variable overrides it.

- **Type:** string
- **Default:** `"info"`
- **Values:** `trace`, `debug`, `info`, `warn`, `error`

## `logs.retention`

How long to keep each log file, such as `4d`. A bare number counts days. `0` keeps none.

- **Type:** string or number
- **Default:** `"4days"`

## `[logs.search]`

The log of interactive search.

### `logs.search.file`

The log file. A relative path is relative to `logs.dir`.

- **Type:** string
- **Default:** `"search.log"`

### `logs.search.enabled`

Write this log. If unset, `logs.enabled`.

- **Type:** boolean

### `logs.search.level`

The least severe level this log records. If unset, `logs.level`.

- **Type:** string
- **Values:** `trace`, `debug`, `info`, `warn`, `error`

### `logs.search.retention`

How long to keep this log, such as `4d`. If unset, `logs.retention`.

- **Type:** string or number
- **Default:** `unset`

## `[logs.daemon]`

The daemon's log.

### `logs.daemon.file`

The log file. A relative path is relative to `logs.dir`.

- **Type:** string
- **Default:** `"daemon.log"`

### `logs.daemon.enabled`

Write this log. If unset, `logs.enabled`.

- **Type:** boolean

### `logs.daemon.level`

The least severe level this log records. If unset, `logs.level`.

- **Type:** string
- **Values:** `trace`, `debug`, `info`, `warn`, `error`

### `logs.daemon.retention`

How long to keep this log, such as `4d`. If unset, `logs.retention`.

- **Type:** string or number
- **Default:** `unset`

## `[logs.ai]`

Atuin AI's log.

### `logs.ai.file`

The log file. A relative path is relative to `logs.dir`.

- **Type:** string
- **Default:** `"ai.log"`

### `logs.ai.enabled`

Write this log. If unset, `logs.enabled`.

- **Type:** boolean

### `logs.ai.level`

The least severe level this log records. If unset, `logs.level`.

- **Type:** string
- **Values:** `trace`, `debug`, `info`, `warn`, `error`

### `logs.ai.retention`

How long to keep this log, such as `4d`. If unset, `logs.retention`.

- **Type:** string or number
- **Default:** `unset`