konfig

https://github.com/aiez/konfig

Portable, self-erasing boilerplate for all my gists: one Makefile (help, doctor, lint, push, pdf, tuned shells/editors/mux), one bashrc, init.lua + init.el, 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 https://github.com/aiez/konfig
git clone https://github.com/aiez/luamine luamine && cd luamine
make help

Sections: NAME

SYNOPSIS

OPTIONS

OUTPUT

SEE ALSO

LICENSE

AUTHOR

Files: Makefile

bashrc

init.lua

init.el

tmux.conf

micro.settings.json

micro.bindings.json

micro.lisp.yaml

style_code.md

style_gist.md

newgist.md

make.md

bash.md

nvim.md

micro.md

tmux.md

banner.sh

help.awk

hist.awk

install.sh

Brewfile

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   https://github.com/aiez/luamine   Lua data mining
optimiz   https://github.com/aiez/optimiz   example datasets
fft       https://github.com/aiez/fft       FFTs + regression trees
repltut   https://github.com/aiez/repltut   REPL tutorial prompts

LICENSE

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

AUTHOR

Tim Menzies <timm@ieee.org>