Frank
c37ad6e870
An index is the skim layer: its entries decide whether a reader opens the page, so an entry that runs 250 characters is a paragraph wearing a bullet. Four entries in `tools/index.md` (`dotfiles-deploy`, `packages`, `pcie-probe`, `remote-job`) now say what the page is for in one line and let the page carry the detail — which is the whole argument for progressive disclosure having an index at all. `engineering/infra/index.md` pointed at `../sdlc.md` with no description at all; it now carries the one from that page's frontmatter, like its four siblings. Refs #64
2.9 KiB
2.9 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 overrides, and the tier's laws. - 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.
- packages —
packages/*.pkgsdesired state, plusinstall.sh(installs the delta) andpkg-inventory.sh(reports drift). - pcie-probe — HIP probes separating PCIe link bandwidth from the engine's read path; refuses to run beside a live service.
- remote-job — Detached
sshjobs with completion sentinels; replaces thetail -f | sedreadiness pattern that lied. - 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.