From 80808d42c257823feb873f80d06b325430c9350e Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sun, 8 Feb 2026 10:09:42 +0200 Subject: add per-project .hexaiconfig.toml config override and lower coverage target to 80% MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Introduce support for a .hexaiconfig.toml file at the git repository root that selectively overrides the global config. Precedence order: defaults → global config → project config → env vars. Also lower the coverage threshold from 85% to 80%. Co-Authored-By: Claude Opus 4.6 --- docs/configuration.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'docs/configuration.md') diff --git a/docs/configuration.md b/docs/configuration.md index f4469a9..10e3c59 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -2,15 +2,22 @@ This page explains where the config lives and how to choose a style; the authoritative list of options and comments lives in the example file. -Config file +Global config file - Location: `$XDG_CONFIG_HOME/hexai/config.toml` (usually `~/.config/hexai/config.toml`). - Style: sectioned tables only — see [config.toml.example](../config.toml.example) for a complete, commented reference. +Per-project config file + +- Place a `.hexaiconfig.toml` at the root of a git repository to selectively override the global config for that project. +- Uses the same TOML format as the global config file — only specify the settings you want to override. +- Hexai auto-detects the git repository root by walking up from the current working directory. +- Precedence (lowest to highest): built-in defaults → global config → per-project config → environment variables. + Environment overrides - All options can be overridden by environment variables prefixed with `HEXAI_`. -- Env values take precedence over the config file. +- Env values always take precedence over both the global and per-project config files. - Examples: - `HEXAI_PROVIDER`, `HEXAI_MAX_TOKENS`, `HEXAI_CONTEXT_MODE`, `HEXAI_CONTEXT_WINDOW_LINES`, `HEXAI_MAX_CONTEXT_TOKENS`, `HEXAI_LOG_PREVIEW_LIMIT`, `HEXAI_REQUEST_TIMEOUT` - `HEXAI_CODING_TEMPERATURE` -- cgit v1.2.3