Project

dotfiles-tui

0.0
No release in over 3 years
dotfiles-tuimr-narender/dotfiles-tuiHomepageDocumentationSource CodeBug TrackerWiki
Interactive terminal UI for managing dotfiles, installing packages via Homebrew, and linking configurations with GNU Stow
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Popularity
Downloads
297
Stars
0
Forks
0
Watchers
0
 Releases
Current version
0.1.0
Total releases
4
First release
1980-01-02
Latest release
1980-01-02
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2025-11-23
Reverse Dependencies
0

 Dependencies

Development

rake
~> 13.0

Runtime

childprocess
~> 4.1
 Project Readme

Dotfiles TUI

A beautiful, interactive terminal UI for managing dotfiles, installing packages, and bootstrapping your development environment.

Installation

From RubyGems (Recommended)

gem install dotfiles-tui

From Source

git clone https://github.com/yourusername/dotfiles.git
cd dotfiles/dotfiles.ruby
gem build dotfiles-tui.gemspec
gem install ./dotfiles-tui-0.0.1.gem

Usage

Simply run the command to launch the interactive menu:

dotfiles-tui

Command-line Options

dotfiles-tui [options]

Options:
  -a, --all             Run all tasks (Link → Install → Link)
  -l, --link            Run stow for linking
  -u, --unlink          Run stow for unlinking
  -c, --cask            Run cask installer
  -f, --formula         Run formula installer
  -m, --mos             Install Mac App Store Apps
  -d, --dry-run         Run in dry-run mode (no changes)
  --secrets-path PATH   Path to secrets directory (default: ~/Documents/Secrets)
  -h, --help            Display help message

Examples

# Interactive mode (default)
dotfiles-tui

# Install formulae only
dotfiles-tui --formula

# Dry run to see what would happen
dotfiles-tui --all --dry-run

# Link configs with custom secrets path
dotfiles-tui --link --secrets-path ~/my-secrets

Features

  • 🎨 Beautiful TUI with animated spinners and clean output
  • 📦 Smart Installation - skips already installed packages
  • 🔗 Intelligent Linking - detects existing symlinks
  • 🔐 Secrets Management - inject private configs from external directory
  • ⚡ Fast - optimized to skip redundant operations
  • 🧪 Dry Run Mode - preview changes before applying

Requirements

  • Ruby >= 2.7.0
  • macOS (for Homebrew features)
  • GNU Stow (auto-installed if missing)

Development

Building Locally

gem build dotfiles-tui.gemspec
gem install ./dotfiles-tui-0.0.1.gem

Publishing

The gem is automatically published to RubyGems when you push a version tag:

# Update version in lib/dotfiles_tui/version.rb
# Commit changes
git tag v0.0.1
git push origin v0.0.1

License

MIT License - see LICENSE for details