bcherb2
b487b0e855
Fresh history. This is the repo a throwaway VM clones anonymously: it brings a
machine to a working baseline and carries nothing that makes it mine.
56 files. 50 land in $HOME, 3 are chezmoi metadata, 2 are repo documentation,
1 is the manifest, and a 15-file test harness stays behind in .tests/.
What did not travel, and why:
encrypted_private_bws-token.age a real credential; age is dropped entirely
.chezmoidata/bws.toml env-var -> secret-id map; belongs with the
tier that can use it
SECRETS.md documentation of the rules, not config
finish-setup.sh.tmpl superseded by dotup
nvim/init.lua.backup dead file
dot_claude/**, dot_codex/**, 120 files of agent config, private tier
dot_pi/**
De-identified rather than dropped:
.gitconfig [user], the GitHub ssh rewrite and both Gitea host rewrites are
identity, not configuration. They move behind an [include] of
~/.config/git/config.local, which the private tier writes. Git
treats a missing include as a no-op, so a public-only machine
reads the file and stops.
.zshrc the two gitea aliases carried a personal domain and a LAN IP.
They move behind a guarded source of ~/.config/zsh/local.zsh,
the sibling of the secrets.zsh seam phase 2 established.
nvim a commented-out LM Studio endpoint naming a LAN address.
ghostty a stale auto-generated header naming an absolute home directory.
Newly captured, never tracked before: ~/.zshenv, ~/.config/gh/config.yml. The
former sourced ~/.cargo/env unguarded, so every zsh on a machine without rustup
printed an error -- the same shape as the unguarded oh-my-zsh source phase 2
fixed. It is guarded now.
.chezmoiexternal.toml grows from one entry to six. oh-my-zsh, powerlevel10k,
zsh-autosuggestions, zsh-ai and tpm were hand-installed and declared nowhere,
which is why `chezmoi init --apply` on a clean box produced a .zshrc that broke
the shell it configures. The theme and both plugins nest under
.oh-my-zsh/custom/, which is what $ZSH_CUSTOM resolves to.
dotup gains an install engine. It resolves each selected package to a channel
(apt, brew, npm, uv, snap, deb, flatpak, tarball, script, builtin) through one
function every consumer reads, probes apt-cache before batching so a name apt
does not know moves to brew instead of failing all thirty, and retries
individually if a batch still fails -- which earned its keep on the first real
container run, where mermaid-cli's puppeteer dependency failed and the other
twelve npm packages installed anyway. --unattended computes safe defaults fresh
from the manifest rather than inheriting a state file, and refuses private and
invasive rows outright even when a stale state file ticks them.
The manifest gains @spec, a second directive kind alongside @needs, carrying the
argument a channel needs but a package name cannot supply -- the scoped npm
name, the flatpak app id, the .deb source. The TSV stays five columns wide.
Three bugs the container runs found, all fixed here:
* `apt install nodejs` gives you node WITHOUT npm on Ubuntu, so all thirteen
npm packages failed on a fresh box. The manifest asks apt for both names.
* A tool installed a moment ago is not on this process's PATH -- uv lands in
~/.local/bin, npm -g honours the ~/.npmrc prefix, linuxbrew is outside a
non-login PATH. Resolved by looking in the places we just wrote to, never by
exporting a modified PATH.
* `A || { B && C; }` is one || list, so when `command -v sudo` failed the list
failed and `set -e` killed dotup at load. On a non-root machine with no
sudo it died before printing anything. There is a regression test.
.zshenv and .p10k.zsh are marked private_. Both are shell code the login shell
executes and both applied at 664, group-writable. Third occurrence of the class
of bug phase 1 found on .pi/agent/auth.json and phase 2 found on .zshrc; the
first one found on purpose rather than by accident.
Verification: 81 assertions, 81/81 on this box and in ubuntu:24.04, ubuntu:22.04
and debian:12. The installer is driven against a directory of fake package
managers that record what they were asked to do and install nothing, so the
engine is exercised end to end without a package landing on the test machine.
`gitleaks detect` over the full history and the working tree: no leaks found,
with no allowlist and no .gitleaks.toml.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
5.3 KiB
5.3 KiB
LazyVim Plugin Cheatsheet
Quick reference for the custom plugins in your configuration.
Git Tools (lua/plugins/git.lua)
git-blame.nvim
Shows git blame information at the end of each line.
Commands:
:GitBlameToggle- Toggle git blame on/off:GitBlameEnable- Enable git blame:GitBlameDisable- Disable git blame:GitBlameOpenCommitURL- Open commit in browser:GitBlameCopySHA- Copy commit SHA to clipboard
Default: Enabled on startup
diffview.nvim
Advanced git diff and history viewer.
Key Bindings:
<leader>gd- Open diff view of current changes<leader>gh- View current file's git history<leader>gH- View entire repo's git history
Commands:
:DiffviewOpen- Open diff view:DiffviewClose- Close diff view:DiffviewFileHistory- View repo history:DiffviewFileHistory %- View current file history:DiffviewRefresh- Refresh the diff view
In Diffview:
]c/[c- Jump to next/previous change<tab>/<S-tab>- Select next/previous filegf- Open file in new tabq- Close diffview
UI Enhancements (lua/plugins/ui-enhancements.lua)
render-markdown.nvim
Renders markdown with better formatting while editing.
Features:
- Automatically styles headers, lists, code blocks
- Works only in markdown files
- No commands needed - always active in
.mdfiles
Toggle: Disable by setting enabled = false in config
hlargs.nvim
Highlights function arguments with different colors.
Features:
- Automatically highlights function parameters
- Helps distinguish arguments visually
- Works across all supported languages
No commands needed - always active
twilight.nvim
Dims inactive code to focus on current block.
Key Bindings:
<leader>ut- Toggle Twilight mode
Commands:
:Twilight- Toggle twilight:TwilightEnable- Enable twilight:TwilightDisable- Disable twilight
Best for: Focusing on specific functions or code blocks
theme-hub.nvim
Browse and switch colorschemes with live preview.
Key Bindings:
<leader>uT- Open Theme Hub
Commands:
:ThemeHub- Open theme browser
In Theme Hub:
j/k- Navigate themes<CR>- Apply selected theme<Esc>/q- Close without applying
Search Tools (lua/plugins/search.lua)
nvim-hlslens
Enhanced search highlighting with match counts.
Key Bindings:
n- Next search result (enhanced)N- Previous search result (enhanced)*- Search word under cursor (enhanced)#- Search word backward (enhanced)g*/g#- Search without word boundaries
Features:
- Shows match count (e.g., "3/15")
- Floating window near cursor
- Automatically clears after cursor movement
search-replace.nvim
Advanced multi-buffer search and replace.
Single Buffer Operations:
<leader>rs- Search/replace in visual selection<leader>ro- Search/replace (open prompt)<leader>rw- Search/replace word under cursor<leader>rW- Search/replace WORD under cursor<leader>re- Search/replace expression<leader>rf- Search/replace filename
Multi-Buffer Operations:
<leader>rbs- Search/replace selections (all buffers)<leader>rbo- Search/replace open (all buffers)<leader>rbw- Search/replace word (all buffers)<leader>rbW- Search/replace WORD (all buffers)<leader>rbe- Search/replace expression (all buffers)<leader>rbf- Search/replace filename (all buffers)
Commands:
:SearchReplaceSingleBuffer- Single buffer mode:SearchReplaceMultiBuffer- Multi-buffer mode:SearchReplaceWithinVisualSelection- Within selection
File Type Tools (lua/plugins/filetypes.lua)
csvview.nvim
Formats and aligns CSV/TSV files for better readability.
Key Bindings:
<leader>cv- Toggle CSV view (only in CSV/TSV files)
Commands:
:CsvViewEnable- Enable CSV formatting:CsvViewDisable- Disable CSV formatting:CsvViewToggle- Toggle CSV view
File Types: Automatically works with .csv and .tsv files
Built-in LazyVim Extras
These are enabled via lazyvim.json and have their own keybindings:
Telescope
<leader>ff- Find files<leader>fg- Live grep<leader>fb- Browse buffers<leader>fh- Help tags
Neo-tree
<leader>e- Toggle file explorer<leader>E- Toggle file explorer (current file)
Harpoon2
<leader>h- Harpoon menu<leader>a- Add file to harpoon
Aerial (Code Outline)
<leader>cs- Open symbols outline
Project Management
<leader>fp- Find project
Tips
- Enable/Disable Plugins: Edit the respective file in
lua/plugins/and setenabled = false - View All Keymaps: Press
<leader>sk(search keymaps) in Telescope - Check Plugin Status: Run
:Lazyto see installed plugins - Update Plugins: Run
:Lazy update - View Help: Most plugins have
:help <plugin-name>documentation
Plugin Files Location
~/.config/nvim/lua/plugins/
├── git.lua # Git blame & diffview
├── ui-enhancements.lua # Render-markdown, hlargs, twilight, theme-hub
├── search.lua # Hlslens, search-replace
├── filetypes.lua # CSV viewer
└── markdown.lua # Markdown-specific config