http://tiny.cc/konfig

Portable, self-erasing boilerplate for all my gists: one Makefile (help, doctor, lint, push, pdf, tuned shells/editors/mux), one bashrc, one init.lua, one tmux.conf, plus isolated nvim/micro configs. A project repo is just knobs plus include $(KONFIG)/Makefile. Every file these tools generate is buried under a .../konfig/... directory — never your real dotfiles — so make death wipes the lot and leaves your machine spotless.

# install and test-drive from any sibling gist
git clone http://tiny.cc/konfig
git clone http://tiny.cc/luamine luamine && cd luamine
make help

Sections: NAME | SYNOPSIS | OPTIONS | OUTPUT | SEE ALSO | LICENSE | AUTHOR

NAME

konfig - shared Makefile + dotfiles for sibling gist repos

SYNOPSIS

# in a project repo's Makefile: knobs, guard, include
KONFIG ?= ../konfig
APP    := project
...
include $(KONFIG)/Makefile

make help|doctor|check|test|push|hist|sh|vi|mux|pdf|death

OPTIONS

Knobs a repo sets before the include (see style_gist.md):

  APP    project name (tmux socket, NVIM_APPNAME, banner)
  MAIN   primary source file        (code repos)
  EXT    source extension           (code repos)
  LANG   language name              (code repos)
  LINT   lint command               (code repos)
  TOOLS  tool:why pairs for doctor
  PKG    packages doctor suggests installing

Tool tutorials: make.md, bash.md, nvim.md, micro.md, tmux.md.
Style law for sibling gists: style_code.md, style_gist.md.
Spinning up a new gist (tool or data): newgist.md.

OUTPUT

make help    banner + every `target: ## desc` line
make doctor  tool checklist with install hints
make sh      tuned bash    (banner, git prompt, vi-mode)
make vi      isolated nvim (catppuccin + tree; --clean)
make mux     private-socket tmux; `make claude` = 3 panes
make pdf     a2ps pretty-print -> ~/tmp/konfig/*.pdf
make death   wipe every generated .../konfig/ dir (2x confirm)

Editors (aliases inside `make sh`): vi=nvim  m=micro.
All state isolated under ~/.{cache,config,local}/konfig/ + ~/tmp/konfig
— nothing touches your real dotfiles; `make death` erases it all.

SEE ALSO

luamine   http://tiny.cc/luamine   Lua data mining
optimiz   http://tiny.cc/optimiz   example datasets
fft       http://tiny.cc/fft       FFTs + regression trees
repltut   http://tiny.cc/repltut   REPL tutorial prompts

LICENSE

MIT. https://choosealicense.com/licenses/mit/

AUTHOR

Tim Menzies <timm@ieee.org>
NC State ©2026, timm, MIT License
150 words of css
designed.2.last