---
title: config.toml
description: Every configuration section of ~/.nori/cli/config.toml.
status: draft
sidebar:
  order: 2
---

Lives at `~/.nori/cli/config.toml` (`$NORI_HOME/config.toml`). Everything is
optional; these are the sections and their load-bearing keys. The full
key-by-key reference will be generated from the config schema.

| Section | Governs | Highlights |
|---|---|---|
| top level | agent & safety | `agent` (default `claude-code`), `approval_policy` (`on-request`), `sandbox_mode` (`workspace-write`), `history_persistence` |
| `[tui]` | the terminal UI | notifications, `notify_after_idle`, `vim_mode`, `auto_worktree` (`automatic`/`ask`/`off`), `file_manager`, `custom_working_messages` |
| `[tui.hotkeys]` | keybindings | see [keybindings](/cli/reference/keybindings/) |
| `[tui.footer_segments]` / `[tui.footer_layout]` | status bar | 11 toggleable segments, per-corner placement |
| `[mcp_servers.<name>]` | MCP servers | stdio or HTTP transport, timeouts, tool filters — see [MCP & hooks](/cli/guides/mcp-and-hooks/) |
| `[hooks]` | lifecycle scripts | 8 sync + 8 async hook points |
| `[[agents]]` | custom ACP agents | see [agents guide](/cli/guides/agents/) |
| `[default_models]` | per-agent model | e.g. `claude-code = "haiku"` |
| `[cloud]` | cloud sessions | `broker_url` |

Command-line overrides win over the file: `-c key=value`.