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..F9, 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+g"    # default; avoids tmux's own Ctrl+B prefix so nightcrow can run inside tmux

[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)

# Reserve startup commands: each [[startup_command]] opens its own terminal
# pane at launch and runs `command` immediately (via `$SHELL -lc <command>`).
# Up to 7 entries (combined with CLI --exec). 7 matches the F3–F9 / <leader>
# 3–9 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 seventh 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 as before.
#
# [[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"