Frank
411b32ff59
Three things were in history that should not have been, all invisible to the tool that deploys them: - `home/dank/.omp/dotfiles/**` — 3 files re-hosting `niri/cfg/autostart.kdl`, `niri/cfg/keybinds.kdl` and `systemd-user/…/swayidle-lock.service` under a prefix `scripts/deploy.sh` never reads (it walks `dotfiles/<pkg>/`). The live package is deployed and symlinked, so the copy asserted nothing; it only misled. Moved to `.AGENTTRASH/20261020-tracked-debt/`. - `.pre-pull-backup/**` — 2 managed-skill files, a local backup in history, which `.gitignore` itself declares must stay on disk only. Same destination. - `dotfiles/noctalia/.local/share/noctalia/wallpapers/` — 23 images, 80.4 MiB. Untracked, files left in place: `~/.local/share/noctalia/wallpapers` symlinks into this directory and the theme reads it, so deleting them would have gone black. Every filename carries its wallhaven ID, so a fresh box restores the set with one `curl` per file plus `deploy.sh`; losing the set is an acceptable outcome, 80 MiB per clone forever is not. New page `omp-docs/tools/dotfiles-deploy.md` owns the deploy contract (the `--check`/sync/`--adopt` modes, `zz-$(hostname)` override semantics, the dconf and systemd-user special cases) because nothing documented it, plus two laws: media the pipeline consumes is content not config, and `systemctl --user enable` snapshots an absolute path — so enabling from a worktree means the seven-day reap silently kills the unit while `is-enabled` keeps answering `enabled`. That second law is not theoretical: `default.target.wants/blankpad-desk-autoswitch.service` pointed into the reaped `wt/de-redesign-20261009` and desk auto-switching had been off since. It is relinked to `dotfiles/zz-blankpad/` and left inactive rather than started mid- session; starting it applies a desk profile. Refs #40
2.5 KiB
2.5 KiB
Tool Documentation
Configuration guides and reference material for installed software. Each tool has its own directory with an index.md entry point.
Available Tools
- applications — Default userspace applications on CachyOS with Niri — browsers, editor, terminal, file manager, audio, screenshots, gaming.
- cachyos — Arch-based rolling release with performance-optimized kernels, repositories, and gaming stack. Running on the workstation.
- comfyui — Node-based AI image generation engine on dankclaw. FLUX.2 klein 4B, CPU backend, systemd managed.
- dotfiles-deploy — How
dotfiles/packages become live config:deploy.shmodes, host override packages, and why theme media and worktree-enabled units are traps. - ghostty — GPU-accelerated terminal emulator with extensive configuration, keybindings, and shaders.
- gitea — Private Git hosting on dankclaw. Quadlet-managed containers: Gitea, PostgreSQL, Caddy.
- handy — Offline speech-to-text transcription with WebKitGTK backend and Tauri v2 UI.
- live-sync — Heartbeat daemon committing machine-written paths (memories, managed-skills, live config, dotfiles) in the command-center checkout; systemd user timer, alerts via ntfy.
- llama.cpp — Local LLM inference server supporting GGUF models with OpenAI-compatible API.
- linux-power-management — Sleep/wake troubleshooting, NVIDIA GPU power management, and diagnostics for Linux systems.
- neovim — Two editors in one binary: vanilla
nvimfor quick edits and thelazyvimNVIM_APPNAME profile, with the base16 wallpaper-palette hook and fresh-box install. - niri — Scrollable-tiling Wayland compositor — configuration, keybindings, and architecture for the workstation.
- noctalia-shell — Native desktop environment for Niri — launcher, control center, settings, lock screen, session menu, hotkey overlay, media controls, and system management.
- tmux — Terminal multiplexer configuration, extended-keys setup, keyboard input best practices, and reload/restart procedures.
Adding a New Tool
- Create a directory:
tools/<tool-name>/ - Add
index.mdas the entry point (no frontmatter for directory listings) - Create concept files with frontmatter if content exceeds one file
- Update this index
Skills tooling lives in /skills/, not in this directory.