config.example.toml

# nightcrow configuration example.
#
# Copy to ~/.nightcrow/config.toml and edit as needed. Every field is
# optional; omitted fields fall back to the defaults shown below.

[layout]
upper_pct = 55       # vertical % for the diff panel (1–99)
file_list_pct = 25   # horizontal % of upper panel for the file list (1–99)

[theme]
name = "yellow"      # accent color preset: "yellow" | "cyan" | "green" | "magenta" | "blue"

[input]
# Leader (prefix) chord. nightcrow app commands are reached tmux-style by
# pressing the leader, then a follow-up key (e.g. <leader> q to quit). Every
# other key — including Ctrl chords like Ctrl+W / Ctrl+L — passes straight to
# the focused terminal so prompt-editing keys reach the program running there.
#
# Allowed form: "ctrl+<letter>" (a single ctrl chord). Reserved no-prefix keys
# (F1..F10, Shift+arrows, Shift+PgUp/PgDn) cannot be used as the leader.
#
# Migration: the old bare-Ctrl app shortcuts moved behind the leader:
#   Ctrl+T → <leader> t   Ctrl+W → <leader> w   Ctrl+L → <leader> l
#   Ctrl+F → <leader> f   Ctrl+O → <leader> o   Ctrl+P → <leader> p
#   Ctrl+Q → <leader> q
# Press the leader twice (<leader> <leader>) to send the literal leader byte
# to the terminal program.
leader = "ctrl+q"    # default; dodges tmux's Ctrl+B and the Ctrl chords an inner
                     # Claude Code pane uses (Ctrl+G=external editor, Ctrl+O/R/S/T/L)

[mouse]
# Capture the mouse: clicking a panel (file list, diff viewer, terminal pane)
# focuses it, clicks on terminal panes are forwarded to programs that asked
# for mouse reports (Claude Code, less --mouse, ...), and wheel scrolls move
# the pane under the pointer. While captured, select
# text in the outer terminal by holding Shift while dragging. Set to false to
# give the mouse back to the outer terminal (plain-drag selection, no click
# forwarding).
enabled = true

[log]
enabled = true
dir = ".nightcrow/logs"   # relative to repo root
rotation = "daily"        # "daily" | "hourly" | "size"
max_size_mb = 10          # used when rotation = "size"
max_days = 7              # delete logs older than N days (0 = keep forever)
level = "info"            # "error" | "warn" | "info" | "debug" | "trace"
prompt_log = false        # record terminal prompt input line by line
commit_log_page_size = 100         # commits fetched per commit-log page (50..=500)
commit_log_prefetch_threshold = 25 # start the next-page fetch when the selection is
                                   # within this many rows of the loaded tail (1..=page_size)

[agent_indicator]
enabled = true            # color recently-touched files in the file list
hot_window_secs = 15      # seconds within which a file stays hot (3–3600)
auto_follow = false       # jump selection to the freshest hot file when idle

[tree]
# Read-only directory-tree navigator (enter with <leader> b). Browse the whole
# working tree and preview any file's contents in the diff pane.
respect_gitignore = true  # hide .gitignore-matched paths (target/, node_modules/, …)
max_depth = 64            # deepest directory level the tree will expand into (1..=1024)
live_watch = true         # watch expanded dirs and refresh the tree live; set false
                          # to refresh only on tree entry (large trees / odd filesystems)

# Reserve startup commands: each [[startup_command]] opens its own terminal
# pane at launch and runs `command` immediately (via `$SHELL -lc <command>`).
# Up to 8 entries (combined with CLI --exec). 8 matches the F3–F10 / <leader>
# 3–9,0 pane-jump keys, so every startup pane is reachable by a direct key
# (F1/F2 reach the file list and diff viewer). This caps only the startup
# batch — open more anytime with <leader> t (panes past the eighth are reached
# via focus cycling, Shift+←/→). `name` labels the tab; when omitted the
# command text is used. With no [[startup_command]] entries, nightcrow opens a
# single empty shell.
#
# [[startup_command]]
# name = "Claude"           # optional tab label; falls back to the command text
# command = "claude"        # required; must not be empty
#
# [[startup_command]]
# command = "cargo test --watch"