A TUI for browsing and managing Hydra configuration hierarchies. Built for the Thousand Brains Project's Monty experiment configs.
╭─ [1] Builder ──────────╮╭─ Viewer ────────────────────────────────╮
│ ▼ /monty: informed_5 ││ │
│ ▶ motor_system_config││ sensor_module: camera │
│ ▶ sensor_module ││ resolution: 640 │
│ learning_module: x ││ frame_rate: 30 │
│ ││ ... │
╰────────────────────────╯│ │
╭─ [2] Variants ─────────╮│ │
│ * default ││ │
│ variant_a ││ │
│ variant_b ││ │
╰────────────────────────╯╰─────────────────────────────────────────╯
Navigate: j/k | Expand: Enter | Help: ? Thousand Brains Project 0.0.1
- Browse Hydra config trees, expand/collapse nodes
- Select, rename, duplicate, delete, and edit variants
- Diff two variants side-by-side with colored output
- Toggle a resolved view to see the fully merged config with all defaults applied
- Fuzzy search over builder items and variants
- Check which experiments reference a variant before you modify it
- Warnings before destructive actions that affect other experiments
- YAML syntax highlighting (configurable Chroma styles)
- Colors, keybindings, warnings, and editor are all configurable via YAML
brew tap thousandbrainsproject/tap
brew install --cask lazyconfigsYou need Go 1.22 or later.
git clone https://github.com/thousandbrainsproject/lazyconfigs.git
cd lazyconfigs
make install # builds and copies binary to ~/.local/bin/Make sure ~/.local/bin is in your PATH.
Other make targets:
make build # build the binary locally
make run # build and run
make test # run unit tests
make clean # remove built binaryRun lazyconfigs from within a git repository that contains TBP Hydra configs:
cd ~/tbp/tbp.monty
lazyconfigsBy default, lazyconfigs walks up from the current directory to find the git root, then looks for configs at <git_root>/src/tbp/monty/conf. This can be overridden in the config file.
| Panel | Description |
|---|---|
Builder [1] |
Hierarchical tree of Hydra config keys and their current values. Expand/collapse nodes to navigate the config structure. |
Variants [2] |
Lists available variant files for the selected builder node. The active variant is marked with *. |
| Viewer | Displays the YAML content of the selected item with syntax highlighting. Shows unified diffs in diff mode. |
Config lives at $XDG_CONFIG_HOME/lazyconfigs/config.yaml (defaults to ~/.config/lazyconfigs/config.yaml). All fields are optional -- omitted values use the defaults shown below.
# Path to the Hydra config directory. Supports environment variables.
# If empty, falls back to <git_root>/src/tbp/monty/conf
conf_dir: ""
# Fallback editor when $EDITOR is unset
editor: "vi"
# Chroma syntax highlighting style (e.g. gruvbox, monokai, dracula)
syntax_style: "gruvbox"
# Per-action confirmation modals. Set to false to skip the modal.
warnings:
delete: true
rename: true
reassign: true
unassign: true
edit: true
# UI colors. Accepts named colors (red, green) or hex (#rrggbb).
colors:
border_focused: "green"
border_unfocused: "default"
cursor: "#6a9fb5"
diff_from: "#ff69b4"
active_variant: "green"
modal_delete_border: "red"
modal_warning_border: "yellow"
modal_help_border: "green"
modal_refs_border: "green"
diff_add: "green"
diff_remove: "red"
diff_hunk: "yellow"
error: "red"
value_ok: "green"
value_error: "red"
# Keybindings grouped by context. Accepts single chars, special keys
# (Enter, Tab, Esc, Space, Shift-Tab, Backspace), and Ctrl combos (Ctrl-d).
keybindings:
general:
quit: "q"
help: "?"
focus_builder: "1"
focus_variants: "2"
panel_next: "l"
panel_prev: "h"
panel_cycle_next: "Tab"
panel_cycle_prev: "Shift-Tab"
cursor_down: "j"
cursor_up: "k"
scroll_viewer_down: "J"
scroll_viewer_up: "K"
toggle_resolved: "v"
search: "/"
escape: "Esc"
builder:
expand_collapse: "Enter"
unassign: "d"
variants:
select: "Space"
duplicate: "d"
rename: "r"
delete: "D"
edit: "e"
diff: "w"
references: "Enter"| Key | Action |
|---|---|
q |
Quit |
? |
Show help |
1 / 2 |
Focus builder / variants panel |
h / l |
Switch panels |
Tab / Shift-Tab |
Cycle panels |
j / k |
Move cursor down / up |
J / K |
Scroll viewer down / up |
v |
Toggle resolved view |
/ |
Fuzzy search |
Esc |
Exit diff mode / close overlay / quit |
| Key | Action |
|---|---|
Enter |
Expand / collapse node |
d |
Unassign selected node |
| Key | Action |
|---|---|
Space |
Select variant (assign to builder node) |
d |
Duplicate variant |
r |
Rename variant |
D |
Delete variant |
e |
Edit in $EDITOR |
w |
Enter diff mode (compare from this variant) |
Enter |
Show experiment references |
cmd/
lazyconfigs/
main.go Entry point
internal/
app/
app.go Core app: layout, panels, keybindings, modal management
search.go Fuzzy search matching and filtered list management
viewer.go Viewer panel logic
config/
config.go Config loading, theme compilation, keybinding parsing
hydra/
hydra.go Hydra config tree parsing and variant reference discovery
resolve.go Deep YAML merging and @package directive resolution
tree.go Tree flattening and item rendering
yamlwrite.go Structure-preserving YAML modification
ui/
diff.go Unified diff generation and colorization
highlight.go Syntax highlighting
render.go UI rendering helpers
version/
version.go Version info
MIT -- see LICENSE.
