Issafalcon dotfiles

Modular terminal tools and configs, managed by a Go TUI (AppImage-friendly).

DISCLOSURE: Tested mainly on Ubuntu 22.04 (native / WSL). Review module scripts before installing.

Quick start (AppImage)

1. Download the AppImage, chmod +x, run it.
2. Satisfy prereqs (git, stow, curl) if prompted.
3. Point the app at a modules directory you own (empty is fine).
4. Add modules as folders with module.yaml (+ scripts/configs). See docs in-app (H) or internal/docs/ADDING_MODULES.md.

The AppImage does not bundle modules — only the TUI and documentation.

Releases are published from version tags (v*) via GitHub Actions — see INSTALL.md.

Layout

go.mod / internal/     # TUI core
tui/                   # main, Makefile, AppImage assets
modules/<name>/        # your packages: module.yaml, install.sh, stow files

From source

git clone <repo> ~/dotFiles
cd ~/dotFiles/tui && make run

Install logs

Install and uninstall script output is appended to dated files under:

~/.local/state/dotfiles-tui/logs/install-YYYY-MM-DD.log

(or $XDG_STATE_HOME/dotfiles-tui/logs/ if set). Only the last two calendar days are kept; older logs are removed automatically.

tail -f ~/.local/state/dotfiles-tui/logs/install-$(date +%F).log

Further help

• Install / AppImage
• Adding modules
• Troubleshooting