Frank
671222b881
Measured fixes, one line each, from the review of everything that landed on 2026-10-20 (issue #60). Each page keeps its own facts; nothing was moved. - inventory/index, index: the census blurb says what the page actually covers (tracked-vs-box-only per file), not "all userspace configuration" - dotfiles-deploy: the wallpaper re-fetch recipe resolves the CDN URL through the wallhaven API — /w/<id> answers text/html, so curl -L never yields a JPEG; description widened to the whole page, tools/index blurb matched - okf-maintenance: the link example and the mistake bullet now agree with okf-spec, which RECOMMENDS absolute bundle paths (they said the opposite) - decisions/index: the unlisted-page gate is kb-coverage.py, not kb-lint - AGENTS.md: the three skill-config subsections are pointers again; the pages own issue tracker, labels and domain docs - swayidle-lock.service: Description names what the unit does (arms the idle lock over noctalia-shell IPC); suspend belongs to noctalia's inhibitor - common.pkgs: git-lfs re-justified by the tracked .gitattributes filter contract; the swayidle comment drops its lid-policy claim
3.2 KiB
3.2 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 the tier's hard-won laws, from media and generated theme output to systemd enable/start semantics, dconf dumps, and idle-lock watcher triage. - 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 and the two tools that keep a machine and its manifest agreeing:install.shinstalls the delta,pkg-inventory.shreports what the machine has outgrown. - pcie-probe — HIP probes that separate PCIe link bandwidth from the engine's read path at the expert-slab size, and the refuse-by-default guard against benchmarking beside a live service.
- remote-job — Detached job runner for
sshwork: completion sentinels on the host replace thetail -f | sed -n /ready/qpattern that reported success on jobs that never finished. - 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.