Конфігурація

# Конфігурація rtok. Кожен прапорець CLI має тут ключ; прапорці та змінні середовища RTOK_* мають пріоритет.
# Пріоритет: типові значення < цей файл < <git root>/.rtok.toml < env < прапорці.
# Документація: docs/config.md. Перевірка: `rtok config validate`. Звідки взялося значення: `rtok config show --sources`.

[core]
enabled     = true                    # false = простий проксі (без бізнес-логіки); HTTP працює до завершення процесу
db_path     = "~/.rtok/rtok.db"       # один файл SQLite, WAL (рішення D8)
archive_dir = "~/.rtok/archive"       # сирі дані для `rtok expand <id>` (рішення D4)
session_env = "CLAUDE_SESSION_ID"     # змінна середовища, з якої береться id сесії, коли його немає в stdin
call_io_inline_bytes = 65536          # тіла MCP/API, більші за це, ідуть в архів (хуки ніколи не архівують)
hook_max_input_bytes = 8388608        # обмеження stdin для rtok hook <event> (8 MiB); понад нього — вихід із кодом 0 без змін, без архівування й гешування (T201)
retain_calls_days    = 30             # 0 = зберігати `calls` назавжди
retain_hook_bodies_days = 3           # тіла stdin хуків очищуються через N днів, рядки лишаються; 0 = доти, доки й `calls` (T352)

[log]                                 # власний лог rtok (D26); його читає `rtok logs`
path      = "~/.rtok/logs/rtok.log"   # ротовані копії лежать поруч: rtok.log.1 … .5
max_bytes = 1048576                   # ротація понад 1 MiB (validate: ≥ 1024)
files     = 5                         # скільки поколінь зберігати; старіші видаляються, ніколи не архівуються (validate: ≤ 20)
lines     = 200                       # що друкує `rtok logs`, коли --lines не задано
level     = "info"                    # error | warn | info | debug
to_db     = true                      # також записувати рядок `logs` для `rtok otel`
tspin     = "auto"                    # `rtok logs` через tailspin: auto = термінал і tspin у PATH | always | off (T225.1)

[estimator]                           # символів на токен для кожного класу, евристика (точність ще не виміряно); `rtok stats --calibrate` переписує
code  = 3.5
prose = 4.2
json  = 3.0
cjk   = 1.0

# ── інтерфейси ──────────────────────────────────────────────────────────────

[hook]                                # rtok hook <event>
host      = "claude"                  # claude | cursor | copilot | devin | cline — зіставлення полів даних (T10.1, T46.3, T87, T94)
max_ms    = 10                        # м'який бюджет; понад нього подія логується як повільна
fail_open = true                      # будь-яка помилка → `{}` і код виходу 0; false лише для налагодження

[agents]                              # реєстр агентів rtok (T282, D34); див. agents-and-worktrees.md
enabled    = true                     # false = хуки пропускають register/touch/end агента й надсилання повідомлень (облік сесій не змінюється)
idle       = "30m"                    # вікно `live()`: немає `ended_at`, а `last_seen` у межах цього проміжку від поточного моменту
push_bytes = 1024                     # оформлені повідомлення, що надсилаються на кожен UserPromptSubmit/PostToolUse; решта → "and N more" (T288)

[agents.usage]                        # rtok agents usage (T358)
source = "logs"                       # logs = власні файли сесій агентів (Claude Code, Codex, OpenCode, Kilo, Copilot CLI, Gemini CLI); rtok = те, що пройшло через rtok; both
hosts  = []                           # [] = кожен хост; інакше id хостів, напр. ["claude", "codex"]
since  = ""                           # "" = увесь час; дата (2026-09-01, цілі дні в tz) або тривалість (30d)
until  = ""                           # "" = по сьогодні; дата, включно
period = "monthly"                    # monthly | daily: нижня таблиця
by     = "agent"                      # agent | model: за чим групує середня таблиця
tz     = ""                           # зона IANA для меж днів і місяців; "" = системна зона

[agents.usage.dirs]                   # звідки `rtok agents usage` читає власні записи кожного хоста (T358.3); Claude Code і Codex використовують [stats] transcripts_dir / codex_dir
opencode = ["~/.local/share/opencode"] # файли opencode*.db у ньому; незмінений типовий шлях слідує за $XDG_DATA_HOME
kilo     = ["~/.local/share/kilo"]     # файли kilo*.db у ньому; незмінений типовий шлях слідує за $XDG_DATA_HOME
copilot  = ["~/.copilot/session-state"] # */events.jsonl; незмінений типовий шлях слідує за $COPILOT_HOME
gemini   = ["~/.gemini/tmp"]           # */chats/session-*; незмінений типовий шлях слідує за $GEMINI_CLI_HOME
droid    = ["~/.factory/sessions"]     # позначається як unsupported, коли є: Factory не документує поля токенів
pi       = ["~/.pi/agent/sessions"]    # */*.jsonl; незмінений типовий шлях слідує за $PI_CODING_AGENT_SESSION_DIR, інакше $PI_CODING_AGENT_DIR/sessions
kimi     = ["~/.kimi-code/sessions"]   # Kimi Code: */*/agents/*/wire.jsonl; незмінений типовий шлях слідує за $KIMI_CODE_HOME
grok     = ["~/.grok/sessions"]        # позначається як unsupported, коли є: xAI вказує на `grok usage`, який rtok не запускає; слідує за $GROK_HOME
zcode    = ["~/.zcode"]                # позначається як unsupported, коли є: ZCode не документує свої записи сесій
antigravity = ["~/.gemini/antigravity"] # позначається як unsupported, коли є: Google не документує локальні дані Antigravity

[agents.junk]                         # rtok agents junk list|clear: межі віку, захищені шляхи, ваші власні шляхи для сміття
keep_logs_days          = 30          # записи `logs` (задокументовані теки логів агентів), змінені за стільки днів, лишаються; 0-3650
temp_min_age_hours      = 24          # записи `temp`, торкнуті за стільки годин, лишаються; 0-87600
stale_session_days      = 30          # лише з `--kind sessions`: сесії, яких не торкалися довше за стільки днів, є сміттям, єдиний критерій тут час; 0-3650; `--session-days N` на один запуск
stale_worktree_days     = 14          # злитий чистий worktree, який видалив би `rtok worktree gc`, стає сміттям (`stale-worktrees`, review), коли простоює стільки днів; 0-3650
crash_dump_min_age_days = 7           # дамп збою в теці `extra` з kind crash-dumps, старший за стільки днів, безпечно чистити, молодший іде як review; 0-3650
exclude                 = []          # glob-и (~ = домашня тека), яких ніколи не чіпають, як і теки зі збігом, напр. ["~/.claude/debug/keep-*"]; хибний glob зберігає все
extra                   = []          # шляхи, які ви визнаєте сміттям (D36), напр. [{ host = "cursor", kind = "cache", path = "~/Library/Application Support/Cursor/CachedData" }]; kind = cache | temp | logs; host = id хоста або rtok

[mcp]                                 # rtok mcp
tools                   = []          # [] = усі інструменти ввімкнених плагінів; інакше список дозволених; `expand` завжди лишається в переліку (D4)
max_description_tokens  = 60          # перевіряється тестом (T4.1)
max_result_chars        = 20000       # понад це — head/tail + id архіву
http                    = "127.0.0.1:8791"  # `rtok mcp --http` без адреси; тримайте на loopback
http_tools              = ["read", "search", "tree"]  # список дозволених для HTTP, замість `tools`; `expand` завжди лишається в переліку; інструменти, що діють від імені агента (`whoami`, `agent_send`, `worktree_add`, …), — ніколи
token                   = ""          # bearer-токен для --http; краще RTOK_MCP_TOKEN; порожній — --http не запускається (T401)
public_url              = ""          # URL тунелю (https://…); лише його хост і origin приймаються ззовні

[proxy]                               # rtok proxy
enabled         = true                # false = простий зворотний проксі (в обхід compress/обліку); НЕ зупиняє HTTP
bind            = "127.0.0.1"
port            = 8790
mode            = "passthrough"       # passthrough | compress
upstream        = "https://api.anthropic.com"      # RTOK_UPSTREAM; ланцюжок за іншим проксі для A/B
openai_upstream = "https://api.openai.com"         # RTOK_OPENAI_UPSTREAM (D11)
gemini_upstream = "https://generativelanguage.googleapis.com"  # RTOK_GEMINI_UPSTREAM (T51.3)
timeout_s       = 600                 # тайм-аут запиту до upstream
include_usage   = true                # потокова передача OpenAI: додати stream_options.include_usage, якщо його немає (T11.2)
context_management = false            # лише Anthropic /v1/messages: додати правку clear_tool_uses + бета-заголовок (T51.2, вмикається явно)
dry_run         = false               # --dry-run: вивести фактичні налаштування [proxy] і вийти, не обслуговуючи запити
# TLS: кореневі сертифікати Mozilla webpki (`use_preconfigured_tls`). Корпоративні CA: SSL_CERT_FILE (PEM, curl). Див. «TLS і корпоративні CA».

[proxy.tools_rewrite]                 # T59.5; вимкнено: байти запиту лишаються ідентичними
enabled = false
max_description_tokens = 60           # 0 = без обрізання; за межею речення; оцінювач Class::Prose
allow = []                            # порожньо = зберігати всі назви, яких немає в deny
deny = []                             # прибрати ці назви з tools[]; подальші виклики все одно пересилаються

[proxy.lanes]                         # T385.1; позначати смугу кожного запиту в журналі обліку (calls.kind); байти лишаються ідентичними
enabled = true                        # false = кожен запит — непозначений api_request; x-rtok-lane і /lane/<name>/ пересилаються як надіслано

[proxy.lanes.bulk]                    # синхронні скрипти; смуга agent слідує глобальним перемикачам, batch і files не переписуються ніколи
compress            = false           # переписування proxy.mode = "compress" (archive, compress, зачистка шуму)
toon                = false           # фільтр toon всередині цього проходу; потрібен compress
tools_rewrite       = false           # proxy.tools_rewrite
context_management  = false           # proxy.context_management
semantic_cache      = false           # plugins.proxy.semantic_cache, читання і запис
flex                = false           # OpenAI service_tier = "flex" on this lane; see [proxy.flex]
timeout_s           = 0               # таймаут читання для цієї смуги; 0 = proxy.timeout_s, але не менше 900 при flex = true (гайд OpenAI щодо Flex бере 15 хв)
upstream            = ""              # базовий URL для кожного запиту цієї смуги, будь-який wire; "" = proxy.upstream / openai_upstream / gemini_upstream
max_in_flight       = 0               # запитів до upstream одночасно; 0 = без ліміту (смуга agent не обмежується ніколи)
max_queued          = 8               # з max_in_flight: скільки запитів чекають на слот; наступний отримує 429 + Retry-After

[proxy.lanes.embeddings]              # ті самі ключі, що в bulk
compress            = false
toon                = false
tools_rewrite       = false
context_management  = false
semantic_cache      = false
flex                = false
timeout_s           = 0
upstream            = ""
max_in_flight       = 0
max_queued          = 8

[proxy.lanes.meta]                    # ті самі ключі, що в bulk (models, підрахунок токенів)
compress            = false
toon                = false
tools_rewrite       = false
context_management  = false
semantic_cache      = false
flex                = false
timeout_s           = 0
upstream            = ""
max_in_flight       = 0
max_queued          = 8

[proxy.lanes.internal]                # ті самі ключі, що в bulk (власні виклики моделі rtok)
compress            = false
toon                = false
tools_rewrite       = false
context_management  = false
semantic_cache      = false
flex                = false
timeout_s           = 0
upstream            = ""
max_in_flight       = 0
max_queued          = 8

[proxy.batch]                         # файли результатів провайдерського Batch
parse_results       = false           # розібрати отриманий файл результатів у рядок usage на запит; тіло пересилається як є

[proxy.flex]                          # OpenAI Flex tier; which lanes get it is [proxy.lanes.<lane>] flex
force               = false           # overwrite a service_tier the client sent (off: a client value is never changed)
on_429              = "none"          # Flex has no capacity: none = the 429 goes to the client | backoff = retry on Flex | default = retry once on service_tier "auto" (the client's own tier, if force replaced one)
retries             = 3               # backoff only: retries before giving up; at most 5
backoff_ms          = 1000            # backoff only: delay before the first retry, doubled each time, capped at 30 s; a 429's Retry-After (seconds) can lengthen it, up to that cap

[proxy.routing]                       # model routing; only the internal and bulk lanes, never the agent lane
enabled             = false           # off: every call keeps the model the client sent

[proxy.routing.bulk]                  # one rule per lane; it acts only with from, to and gate all set
from                = []              # request models it applies to: an exact id or a prefix ending in * (empty = off)
to                  = ""              # the model that serves a matching call (empty = off)
provider            = ""              # provider slug recorded for a routed call (empty = the wire's own); pair with [proxy.lanes.<lane>] upstream
gate                = ""              # where the quality bench for this swap is kept (a path, URL or run id); empty = off

[proxy.routing.internal]              # same keys as bulk (rtok's own model calls)
from                = []
to                  = ""
provider            = ""
gate                = ""

[web]                                 # rtok web (ті самі дані, що й у rtok tui)
host = "127.0.0.1"                    # --host
port = 3333                           # --port

[tui]                                 # rtok tui (ті самі дані, що й у rtok web)
tab       = ""                        # "" = перша вкладка       (--tab <page>)
tick_secs = 2                         # частота повторного читання моделі, як 2-секундний такт у web (--tick-secs)

[ui]                                  # власні рядки rtok у терміналі; канали й --json лишаються простими
emoji = true                          # емодзі перед рядками статусу/попереджень/помилок (RTOK_UI_EMOJI)
color = true                          # розфарбовувати їх; діють NO_COLOR/CLICOLOR_FORCE (RTOK_UI_COLOR)

[stats]                               # rtok stats
since           = "30d"
format          = "table"             # table | json      (--json)
plugin          = ""                  # "" = усі         (--plugin <id>)
transcripts_dir = "~/.claude/projects"
codex_dir       = "~/.codex/sessions" # логи Codex CLI → ще один рядок `api` (T49.2); OpenCode і Copilot CLI читає `rtok agents usage` ([agents.usage.dirs], T358.3); сховища Cursor не містять кількості токенів (перевірено 2026-09-17), тож їх не читають
calibrate_samples = 30                # на клас          (--calibrate)
baseline        = ""                  # типова назва для --compare; "" = немає
price           = false               # показувати вартість у USD для кожної моделі (--price)
# рядки USD за MTok для --price (T49.1). Джерела, отримано 2026-09-17 (Anthropic claude-fable-5-1,
# claude-opus-5-5 і claude-sonnet-5-5: 2026-10-08):
# Anthropic claude-* рядки: https://platform.claude.com/docs/en/about-claude/pricing
# (вхід / запис у кеш на 5m / читання з кешу / вихід). OpenAI gpt-5 / gpt-5-mini:
# https://platform.openai.com/docs/pricing (вхід із коротким контекстом / кешований вхід /
# вихід; окремої ціни запису немає, тож cache_write = input). Моделі без рядка
# виводять `-`, а не здогадку; додавайте власні датовані рядки так само.
[stats.prices."claude-fable-5-1"]
input = 10.0
cache_write = 12.5
cache_read = 0.25
output = 50.0
[stats.prices."claude-opus-5-5"]
input = 4.0
cache_write = 5.0
cache_read = 0.2
output = 20.0
[stats.prices."claude-sonnet-5-5"]
input = 2.0
cache_write = 2.5
cache_read = 0.1
output = 10.0
[stats.prices."claude-sonnet-5"]
input = 2.0
cache_write = 2.5
cache_read = 0.2
output = 10.0
[stats.prices."claude-haiku-4-5"]
input = 1.0
cache_write = 1.25
cache_read = 0.1
output = 5.0
[stats.prices."gpt-5"]
input = 1.25
cache_write = 1.25
cache_read = 0.125
output = 10.0
[stats.prices."gpt-5-mini"]
input = 0.25
cache_write = 0.25
cache_read = 0.025
output = 2.0
# Рівні Batch і Flex, отримано 2026-10-08: ключ — `<model>@batch` або `<model>@flex`, а `--price`
# рахує usage смуги Batch за рядком `@batch`. Anthropic Batch — знижка 50 % на вхід і вихід,
# множники кешу накладаються зверху (сторінка цін вище; рівня Flex немає). В OpenAI Batch і Flex
# мають однакові ставки (https://developers.openai.com/api/docs/pricing).
[stats.prices."claude-fable-5-1@batch"]
input = 5.0
cache_write = 6.25
cache_read = 0.125
output = 25.0
[stats.prices."claude-opus-5-5@batch"]
input = 2.0
cache_write = 2.5
cache_read = 0.1
output = 10.0
[stats.prices."claude-sonnet-5-5@batch"]
input = 1.0
cache_write = 1.25
cache_read = 0.05
output = 5.0
[stats.prices."claude-sonnet-5@batch"]
input = 1.0
cache_write = 1.25
cache_read = 0.1
output = 5.0
[stats.prices."claude-haiku-4-5@batch"]
input = 0.5
cache_write = 0.625
cache_read = 0.05
output = 2.5
[stats.prices."gpt-5@batch"]
input = 0.625
cache_write = 0.625
cache_read = 0.0625
output = 5.0
[stats.prices."gpt-5@flex"]
input = 0.625
cache_write = 0.625
cache_read = 0.0625
output = 5.0
[stats.prices."gpt-5-mini@batch"]
input = 0.125
cache_write = 0.125
cache_read = 0.0125
output = 1.0
[stats.prices."gpt-5-mini@flex"]
input = 0.125
cache_write = 0.125
cache_read = 0.0125
output = 1.0

[report]                              # rtok report (D24: відображає операторську модель, нічого не обчислює)
format = "md"                         # md; html (T22.2), pdf (T22.3), --ai (T22.4)
out    = ""                           # "" = stdout     (--out <path>)
since  = "30d"                        # наскільки далеко в минуле читає звіт
ai     = false                        # відображення у формі для моделі замість --format (--ai)
budget_tokens = 8000                  # --ai відкидає цілі розділи понад це (T22.4)

[bench]                               # rtok bench
tasks    = "bench/tasks.toml"
runs     = 3
dry_run  = false
timeout_s = 900                       # на один запуск задачі
suite    = ""                         # "" = шість задач T9.1; "graph" = T68.9 з MCP і без
[bench.configs]                       # назва = файл налаштувань, що передається в `claude --settings`
a = "bench/configs/legacy.json"
b = "bench/configs/rtok.json"

[doctor]                              # rtok doctor
settings_path   = "~/.claude/settings.json"
claude_json     = "~/.claude.json"
mcp_json        = ".mcp.json"
probe_timeout_ms = 500                # на кожну перевірку /health вузла проксі
mcp_timeout_ms  = 15000               # на tools/list кожного MCP-сервера (сервери uvx/npx запускаються повільно)
instruction_warn_tokens = 1000        # --instructions: позначати файли, більші за це
instructions    = false               # типово запускати аудит інструкцій (--instructions)

[setup]                               # rtok agents install / remove <host>
dry_run      = false
yes          = false                  # потрібно для --replace
backup       = true                   # <name>.bak-<ts> поруч із кожним файлом, перш ніж setup і remove його змінять
backup_files = 5                      # скільки поколінь .bak-* зберігати на файл; старіші видаляються (0 = зберігати всі)
hook_timeout_s = 5                    # тайм-аут, що записується в кожен запис хука
modes        = []                     # наприклад ["terse", "yagni"]   (--mode)
mcp          = true                   # також зареєструвати MCP-сервер   (--mcp)
proxy        = false                  # також задати base URL           (--proxy)
[setup.claude]
settings_path = "~/.claude/settings.json"
[setup.cursor]
hooks_path    = "~/.cursor/hooks.json"  # сьогодні лише beforeShellExecution (T10.11 підключає PostToolUse)
[setup.codex]
config_path   = "~/.codex/config.toml"
[setup.opencode]
config_path   = "~/.config/opencode/opencode.json"
[setup.kilo]
config_path   = "~/.config/kilo/kilo.json"      # kilo.jsonc об'єднує сам Kilo, rtok його ніколи не переписує
[setup.pi]
extensions_path = "~/.pi/agent/extensions"
tools           = false                     # pi.registerTool для read/search/graph/memory (T70.3)
[setup.omp]
extensions_path = "~/.omp/agent/extensions" # oh my pi: сюди створюється посилання на plugins/pi (T92)
mcp_path        = "~/.omp/agent/mcp.json"
[setup.zcode]
config_path   = "~/.zcode/cli/config.json"
[setup.kimi]
config_path   = "~/.kimi-code/config.toml"  # mcp.json читається поруч
[setup.copilot]
dir           = "~/.copilot"                # mcp-config.json, hooks/rtok.json
[setup.commandcode]
dir           = "~/.commandcode"            # settings.json (ключ hooks), mcp.json
[setup.aider]
config_path   = "~/.aider.conf.yml"         # openai-api-base → rtok proxy (--proxy)
[setup.windsurf]
config_path   = "~/.codeium/windsurf/mcp_config.json"
[setup.zed]
config_path   = "~/.config/zed/settings.json"
[setup.cline]
hooks_path = "~/Documents/Cline/Hooks"
mcp_path = "~/.cline/data/settings/cline_mcp_settings.json" # CLI; розширення використовує файл налаштувань у globalStorage VS Code
[setup.gemini]
dir = "~/.gemini" # settings.json (hooks, mcpServers)
[setup.codewhale]
dir = "~/.codewhale" # config.toml ([[hooks.hooks]]), mcp.json (mcpServers)
[setup.mimo]
config_path   = "~/.config/mimocode/mimocode.json" # mcp (у форматі форку OpenCode)
[setup.antigravity]
plugins_path     = "~/.gemini/config/plugins"          # Antigravity 2.0 / IDE: сюди створюється посилання на plugins/antigravity
cli_plugins_path = "~/.gemini/antigravity-cli/plugins" # сюди готує файли agy plugin install; лише читання
[setup.devin]
config_path   = "~/.config/devin/config.json"  # mcp_config.json читається поруч; Windows: %APPDATA%\devin\
[setup.roo]
mcp_path      = ""                               # порожньо: <Code user dir>/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
[setup.junie]
mcp_path      = ""                               # порожньо: ~/.junie/mcp/mcp.json (користувацький файл MCP Junie CLI)
[setup.qwen]
dir           = "~/.qwen"                    # settings.json (хуки, mcpServers); QWEN_HOME переносить каталог
[setup.codebuddy]
dir           = "~/.codebuddy"               # CodeBuddy Code: settings.json (хуки), .mcp.json, plugins/; CODEBUDDY_CONFIG_DIR переносить каталог
workbuddy_dir = "~/.workbuddy"               # WorkBuddy Desktop: ті самі файли (вбудований CodeBuddy Code; неперевірено)
[setup.goose]
config_path   = "~/.config/goose/config.yaml"  # Goose CLI and Desktop: extensions.rtok; Windows: %APPDATA%/Block/goose/config/config.yaml; GOOSE_PATH_ROOT: <root>/config/config.yaml
[setup.droid]
mcp_path      = "~/.factory/mcp.json"        # Factory Droid: користувацький файл MCP-серверів (mcpServers)
[setup.kiro]
mcp_path      = "~/.kiro/settings/mcp.json"      # Kiro IDE and CLI: user-level MCP servers (mcpServers)
[setup.amp]
settings_path = "~/.config/amp/settings.json"    # Amp: user settings; amp.mcpServers holds MCP servers (settings.jsonc if it is the only one)
[setup.warp]
mcp_path      = "~/.warp/.mcp.json"          # Warp: користувацький файл MCP-серверів (mcpServers)
[setup.continue]
config_path   = "~/.continue/config.yaml"        # Continue (VS Code, JetBrains, cn): mcpServers item rtok; Windows: %USERPROFILE%/.continue/; CONTINUE_GLOBAL_DIR moves it
[setup.crush]
config_path   = "~/.config/crush/crush.json" # Crush: global JSON config (mcp.rtok); CRUSH_GLOBAL_CONFIG or XDG_CONFIG_HOME move it
[setup.openhands]
mcp_path      = "~/.openhands/mcp.json"     # OpenHands: користувацький файл MCP-серверів (mcpServers)
[setup.augment]
settings_path = "~/.augment/settings.json"   # Auggie CLI: користувацькі налаштування, mcpServers
[setup.reasonix]
dir           = "~/.reasonix"                # Reasonix: config.toml (MCP-сервери в [[plugins]]); REASONIX_HOME переносить каталог (Windows: %APPDATA%/reasonix)

[expand]                              # rtok expand <id>
max_lines = 0                         # 0 = без обмежень (--lines a-b задається для виклику)
max_rate  = 0.05                      # стеля повторних читань; понад неї звіт позначає стиснення з втратами (T22.5)

[filter]                              # rtok filter --stdin (T10.2)
cmd = ""                              # підказка сімейства команди, коли викликач його знає (--cmd)

[worktree]                            # rtok worktree add | claim | remove | list | gc
enabled = true                        # false: кожна команда `rtok worktree` (і list) каже, що worktree не ввімкнено, MCP не показує жодного інструмента worktree_*, а хуки Claude WorktreeCreate/WorktreeRemove роблять те, що Claude робить без rtok
root = "~/.rtok/worktrees"            # де `rtok worktree add` створює worktree, як <root>/<repo>-<task>; `~` розкривається

[tasks]                               # адаптери задач (T441); зазвичай задаються для проєкту в .rtok.toml
adapter = "disk"                      # disk | github | gitlab
prefix = ""                           # префікс id задач, 1–8 ASCII-літер (R → R12, R2.1); порожньо: перша літера назви проєкту

[tasks.disk]
dir = "tasks"                         # один Markdown-файл на задачу, відносно кореня проєкту; виконані йдуть у <dir>/done

[tasks.github]
repo = ""                             # owner/name; порожньо: remote origin
project = 0                           # номер Projects v2 власника репо: issues потрапляють у нього, поле Status слідує за задачею; 0 = лише issues

[tasks.gitlab]                        # мітки status::in-progress | status::done | status::wont-do; підзадача пов’язана з батьківською (relates_to)
url = "https://gitlab.com"            # https базова URL; задайте для власного інстансу; токен: GITLAB_TOKEN, GITLAB_ACCESS_TOKEN, GL_TOKEN, інакше glab
project = ""                          # group/name або числовий id; порожньо: remote origin

[tasks.export.github]                 # `rtok task export github`: односторонньо віддзеркалити завдання з диска в GitHub Issues
repo = ""                             # owner/name; порожньо: [tasks.github] repo, інакше remote origin

[tasks.export.linear]                 # `rtok task export linear`: односторонньо віддзеркалити завдання з диска в Linear; токен у LINEAR_API_KEY
team = ""                             # короткий ключ команди, наприклад "ENG"; порожньо: експорт не запускається

[otel]                                # експорт OpenTelemetry (D19); вимкнено, доки не визначено endpoint
endpoint      = ""                    # базова URL-адреса OTLP/HTTP, наприклад "http://localhost:4318"; "" = $OTEL_EXPORTER_OTLP_ENDPOINT
headers       = ""                    # "k=v,k2=v2", наприклад "signoz-ingestion-key=…"; "" = $OTEL_EXPORTER_OTLP_HEADERS
service_name  = "rtok"                # service.name ресурсу
content       = true                  # gen_ai.input/output.messages, аргументи й результати інструментів у спанах
content_bytes = 65536                 # на атрибут; понад це — rtok.archive.id → `rtok expand <id>`
flush_secs    = 5                     # інтервал скидання для proxy / mcp і тайм-аут POST

# ── плагіни ─────────────────────────────────────────────────────────────────

[plugins.measure]
enabled = true

[plugins.cmd]
enabled  = true
rewrite  = true                       # PreToolUse(Bash) → `rtok run -- …`
shell    = ""                         # "" = $SHELL
rules    = "~/.rtok/rules.toml"       # додаткові правила фільтрування; якщо немає → вбудований rules/default.toml
rules_dir = "~/.rtok/rules.d"         # drop-in-файли: кожен *.toml об'єднується після rules у порядку назв (T50.2)
trailer_min_lines = 40                # додавати `[rtok <id> · N lines · expand …]` понад це
fail_tail_lines   = 80                # ненульовий код виходу → останні N рядків дослівно
never_wrap = ["rtok", "sudo"]         # список заборонених перших слів; heredoc, `&`, -i завжди пропускаються

[plugins.read]
enabled          = true
default_mode     = "full"             # full | lines | map | signatures
max_chars        = 20000              # понад це — head/tail + id архіву
native_max_bytes = 32768              # поріг відмови для PreToolUse(Read); ніколи не нижче за це
range_max_lines = 300              # T383: нативний Read із limit 1..=N проходить хук; 0 = лише без діапазону
advice           = true               # false = ніколи не відмовляти нативному Read
allow_paths      = []                 # додаткові корені поза cwd
search_max       = 50
search_max_bytes = 1048576             # пошук пропускає файли, більші за це (T55.5)
tree_depth       = 2
delta            = true               # T58.1: змінене повторне читання → unified diff щодо останнього архіву (7.3 % байтів Read, 2026-09-18, `rtok stats --since 90d`)
delta_max_ratio  = 0.6                # повний файл, коли diff не менший за цю частку

[plugins.json_tree]
enabled = false                     # fold repeated nested JSON in old tool results; off until a measurement shows a saving

[plugins.archive]
enabled    = true
keep_turns = 4                        # ніколи не торкатися останніх N ходів
min_tokens = 1500                     # переписувати лише результати інструментів понад це (оцінка)
head_lines = 8
tail_lines = 4
tiers      = false                    # багаторівневе завантаження, вмикається явно (типово вимкнено); специфікація поведінки OpenViking L0/L1/L2 — AGPL-3.0, rtok не вендорить, не лінкує й не запускає її як підпроцес (D6); відкриває нативну реалізацію в T33.2
live_blobs = false                    # зменшувати вкладені дампи JSON + блоки data: у блоках користувача, ніколи results/system/tools/останні 2 ходи (T51.1, вмикається явно)
skills     = true                     # архівувати тіла skills поза keep_turns (T61.2); вимикається через skills = false

[plugins.proxy]
enabled = true                        # плагін proxy (фіксація використання); сам сервер — це [proxy]

[plugins.inject]
enabled       = true
budget_tokens = 800                   # на хід, усі вставлення разом (рішення D5)
modes_dir     = "~/.rtok/modes"
modes         = []                    # те саме, що й [setup].modes; setup записує сюди

[plugins.guard]
enabled      = true
window_turns = 8
deny_grep_glob = false           # вмикається явно: відмовляти нативним Grep/Glob, спрямовувати до MCP search/tree (T50.4)
grep_symbol = false              # вмикається явно: Grep одного ідентифікатора (`foo`, `fn foo`, `class Foo`, `\bfoo\(`) відхиляється з його 1-5 індексованими визначеннями та кількістю посилань; лише пошук в індексі (T369)
skills = false                   # вмикається явно (Claude Code): відмовляти Skill, чий SKILL.md перевищує skill_max_bytes, із його картою + `expand <id>` (T62.1)
skill_max_bytes = 8192           # тіла такого розміру або менші завантажуються цілком; так само будь-який skill з allowed-tools / model / context / agent у frontmatter

[plugins.memory]
enabled        = true
recall_titles  = 5                    # SessionStart: останні N заголовків + id
recall_tokens  = 200
prompt_recall  = 5                    # UserPromptSubmit: 0 = вимкнено; N = ранжовані заголовки на хід (T69.5)
checkpoint_tokens = 400               # PreCompact → SessionStart(compact)
search_limit   = 5
sync_tokens    = 300                  # rtok memory sync: блок у CLAUDE.md / AGENTS.md (T69.6)
startup_recall = true                 # SessionStart(startup) відновлює найновішу нотатку session:* (T71.2)
handoff        = true                 # MCP-інструмент T59.6 для зведення субагента
spawn_brief        = true             # T130: зведення-вказівник для SubagentStart
spawn_brief_tokens = 300              # T130: бюджет токенів для брифу під час запуску

[plugins.memory.embed]
enabled    = false                    # P29: якщо false — лише FTS5; векторний пошук вмикається явно
provider   = "local"                  # "local" | "openai"
model      = "all-MiniLM-L6-v2"
dimensions = 384
hybrid     = true                     # коли ввімкнено: RRF(fts5, knn) для mem_search і prompt_recall; хук читає лише збережені вектори; false = лише knn

[plugins.graph]
enabled    = true
max_tokens = 2000                     # на відповідь; понад це: head + "N more, expand <id>"
impact_tokens = 1500                  # impact: файли згруповано й ранжовано в межах цього бюджету, далі "+K files, M refs not shown"; --all або 0 = усі рядки
map_tokens = 0                        # обмеження карти репозиторію на SessionStart (частка D5 поряд із memory.recall_tokens); 0 = вимкнено, доки не пройде A/B P7
map_rank   = "refs"                   # порядок карти на SessionStart: refs = посилання на ім'я; pagerank = файли за персоналізованим PageRank, персоналізованим нещодавно редагованими файлами й останнім checkpoint після compact
body_lines = 40                       # symbol(): скільки рядків коду показувати на визначення
auto_index = true                     # true = кожен виклик обходить дерево; false = індексувати один раз, далі `rtok graph index` або спостерігач (файл, позначений хуком як застарілий, до того читається як відсутній)
auto_add_projects = true               # T329.6: реєструвати каталог у реєстрі проєктів, коли там стартує сесія з хуками, створюється або приєднується worktree через `rtok worktree` (під назвою його гілки) або виконується виклик graph MCP; false = реєстр змінюється лише через сторінку й CLI
backend    = "tags"                   # tags | lsp | auto | text: tags = tree-sitter index (default); lsp = language server from PATH, tags when it cannot answer; auto = per project and language, server first, tags second, text search when no grammar parses the project; text = in-process text search only (no call graph, no dead)
lsp_timeout_ms = 40000                # how long one language-server wait (starting, still indexing) may take before the request falls back to tags
backend_by_language = {}              # backend for one language, e.g. { go = "tags", rust = "lsp" }
watch      = "off"                    # off | notify: фонове переіндексування всередині `rtok mcp` (P8d)
auto_link_references = true           # T329.8: йти за посиланнями в маніфестах (Cargo path, npm file:/link:, go replace, Python path, submodules) в інші каталоги, реєструвати й автоматично зв'язувати їх
reference_depth = 3                   # T329.8: скільки рівнів посилань іти від проєкту (A -> B — це 1); досягнення межі показується й логується
max_auto_projects = 20                # T329.8: найбільше проєктів, які посилання можуть додати до реєстру; досягнення межі показується й логується
alerts = true                         # T329.17: сповіщати, коли проєкт області зник, недоступний, має збійний бекенд або зламане посилання маніфесту; показують rtok doctor, graph projects і відповіді graph
health_check_interval_s = 60          # T329.17: секунд між перевірками здоров'я в rtok mcp і rtok web (сповіщення потребує двох поспіль); 0 = вимкнено
live_heat_window_s = 300            # T329.34: секунд, скільки вузол лишається «теплим» на живому полотні графа після виклику (rtok web, rtok tui)
live_max_events_per_s = 50          # T329.34: скільки подій викликів жива панель показує за секунду; лічильники рахують кожен виклик
live_feed_rows = 200                # T329.34: скільки завершених викликів зберігає жива стрічка (1-1000)

[plugins.toon]
enabled  = true
min_rows = 5

[plugins.compress]
enabled = true                        # екстрактивні зведення заархівованого виводу інструментів; працює лише в proxy.mode = "compress"

[plugins.compress.llm]
enabled           = false             # P28: model summaries of archived output via the internal lane; needs proxy.mode = "compress"
url               = ""                # where the compressor posts; empty = this proxy (proxy.bind:proxy.port)
model             = "claude-haiku-4-5"
max_input_bytes   = 65536             # larger archived results keep the extractive view
max_output_tokens = 512
max_spans         = 64                # more must-keep spans than this keep the extractive view
max_in_flight     = 2                 # compressor calls at once
timeout_s         = 60
code              = false             # also summarise diffs and source; off = logs and prose only

[plugins.docs]
enabled        = false                # локальний rustdoc з Cargo.lock + кешований JSON docs.rs (T455)
query_limit    = 5                    # стеля влучань docs_query
snippet_chars  = 400                  # символів на FTS-фрагмент
max_tokens     = 800                  # стеля оцінки всієї відповіді; зайві влучання відкидаються

[plugins.wasm]
enabled = false                      # типово вимкнено; жоден .wasm не завантажується до хоста T32.2 + feature `wasm-host`
dir     = "~/.rtok/plugins"          # шукати *.wasm на один рівень углиб; D6 — цей репозиторій ніколи не вендорить сторонніх плагінів

[plugins.proxy.semantic_cache]
enabled = false
threshold = 0.99
ttl_s = 300
max_messages = 1
require_empty_tools = true
embed_backend = "hash"
cache_by_model = true
cache_by_provider = true

[proxy.batch]
parse_results = false

[proxy.lanes.bulk]
flex = true

[proxy.flex]
force = false
on_429 = "backoff"

[proxy.routing]
enabled = true

[proxy.routing.bulk]
from = ["claude-sonnet-*"]
to = "claude-haiku-4-5"
gate = "bench/bulk-haiku-2026-10.md"

[ui]
emoji = false   # RTOK_UI_EMOJI=false
color = false   # RTOK_UI_COLOR=false

RTOK_PROXY_MODE=compress rtok proxy
RTOK_PLUGINS_READ_ALLOW_PATHS=/opt/src,/srv/lib rtok mcp
RTOK_PLUGINS_WASM_ENABLED=true rtok config show --sources
RTOK_STATS_SINCE=7d rtok stats
RTOK_CONFIG=./ci-config.toml rtok bench --dry-run

RUST_LOG=rtok=debug rtok stats                       # argv, потім кожен рядок [log] у момент запису
RUST_LOG=rtok::log=info rtok proxy                   # лише віддзеркалений потік [log]
RUST_LOG=rtok=debug RUST_LOG_STYLE=never rtok mcp    # без кольору; stdout лишається каналом MCP