# [threads]

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

AI agent threads, which `atuin threads` lists and resumes.

## `threads.capture`

Whether the daemon captures live coding-agent threads (Claude Code, Codex, ...) into the
synced record store. Off by default: capture copies the conversation (what was said, and
the tools called, see `capture_tools`) into the encrypted store used by sync, so
it is strictly opt-in. `atuin setup --only --threads --daemon` turns it on, with the
daemon it needs.

- **Type:** boolean
- **Default:** `false`

## `threads.capture_tools`

With `capture`, also capture what each tool call was given and what it returned
(commands and their output, files read and written), so a resumed thread has them too. On
by default, with secrets redacted and each payload held to 64 KiB; off keeps only each
tool's name.

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

## `threads.filter_mode`

The filter the picker opens in. Unset: `global`. A mode that can't apply here opens in
`workspace` inside a git repository (`branch` on a detached `HEAD`), else in `global`; and
`workspace` opens in `global` when the workspace has no threads at all.

- **Type:** string
- **Default:** `unset`
- **Values:**
  - `global`: Every thread, from every host.
  - `host`: Threads recorded on this host.
  - `workspace`: Threads whose working directory is inside the current git repository.
  - `directory`: Threads started in the current directory.
  - `branch`: Threads on the current git branch of the current repository.

## `threads.inline_height`

Height of the inline picker. Unset: the top-level `inline_height`.

- **Type:** integer
- **Default:** `unset`

## `threads.resume_chooser`

Ask where to resume a thread once it's chosen (enter or tab): in its own harness, or
continued in another one installed here. When false, a thread resumes in its own harness
straight away; the chooser still opens for one that can't.

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

## `threads.mouse`

Take the mouse: the wheel scrolls the preview under it, or moves the selection over the
list. While the picker has the mouse, most terminals still select text with shift held
while dragging (option in iTerm2, fn in macOS Terminal). Unset: as the top-level
`no_mouse` says (on, by default).

- **Type:** boolean
- **Default:** `unset`

## `[threads.resume]`

Per-harness resume command templates.

### `threads.resume.claude`

The command that resumes a Claude Code thread.

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

### `threads.resume.codex`

The command that resumes a Codex thread.

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

### `threads.resume.grok`

The command that resumes a Grok thread.

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

### `threads.resume.opencode`

The command that resumes an opencode thread.

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

### `threads.resume.pi`

The command that resumes a pi thread.

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

### `threads.resume.omp`

The command that resumes an omp thread.

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

### `threads.resume.copilot`

The command that resumes a GitHub Copilot thread.

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

### `threads.resume.amp`

The command that resumes an Amp thread.

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

### `threads.resume.kiro`

The command that resumes a Kiro thread.

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

### `threads.resume.hermes`

The command that resumes a Hermes thread.

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