Rig

██████ ██ ██████
██ ██ ██ ██
██████ ██ ██ ███
██ ██ ██ ██ ██
██ ██ ██ ██████

Automated system setup for Fedora Linux and macOS.

Quick Start

One-line Installer

eval"$(curl -fsSL https://raw.githubusercontent.com/pixincreate/rig/main/unix/setup)"

The installer automatically:

• Detect your platform (Fedora or macOS)
• Clone the dotfiles repository to ~/dev/.dotfiles
• Clone this repository to ~/dev/.rig
• Prompt you for Git name/email, NextDNS config, etc.
• Run the complete setup

Configuration

Settings are read from config.json first. Edit before running:

vim unix/fedora/config.json # or unix/macos/config.json

{
"git": {
"user_name": "Your Name",
"user_email": "your@email.com"
},
"secureboot": true
}

Optional: Override via environment variables:

export RIG_GIT_NAME='Your Name'export RIG_GIT_EMAIL='your@email.com'export RIG_NEXTDNS_ID='abc123'export RIG_SECUREBOOT='true'# Fedora onlyeval"$(curl -fsSL https://raw.githubusercontent.com/pixincreate/rig/main/unix/setup)"

Manual Installation

# macOS
git clone https://github.com/pixincreate/dotfiles.git ~/.dotfiles
git clone https://github.com/pixincreate/rig.git ~/.rig
cd~/.rig/unix/macos
./macos-setup
# Fedora
git clone https://github.com/pixincreate/dotfiles.git ~/.dotfiles
git clone https://github.com/pixincreate/rig.git ~/.rig
cd~/.rig/unix/fedora
./fedora-setup

Unified CLI

Rig includes a unified CLI dispatcher on both Fedora and macOS. Run it from anywhere after setup:

rig # List all available commands with descriptions
rig add base neovim # Add a package to a list
rig pkg-manage # Interactive package manager
rig stow --all # Stow all dotfiles
rig install skillset # Install rig skill to skillset repo
rig webapp-install "ChatGPT""https://chat.openai.com""icon.png"

The dispatcher uses multi-word prefix routing (inspired by omarchy): rig install skillset dispatches to rig-install-skillset. Run rig without arguments to see all available commands.

Each platform has its own dispatcher (unix/fedora/bin/rig and unix/macos/bin/rig) which discovers local rig-* scripts plus shared commands from unix/common/bin/.

Running Individual Components

Both macOS and Fedora support running specific modules:

./macos-setup --only <module-path># macOS
./fedora-setup --only <module-path># Fedora

macOS Modules

./macos-setup --only dotfiles/stow # Stow all packages
./macos-setup --only dotfiles/zsh # Configure ZSH
./macos-setup --only dotfiles/fonts # Install fonts
./macos-setup --only packaging/homebrew # Install Homebrew
./macos-setup --only packaging/brew # Install brew packages
./macos-setup --only packaging/cask # Install cask apps
./macos-setup --only config/git # Git & SSH
./macos-setup --only config/nextdns # NextDNS

Fedora Modules

./fedora-setup --only dotfiles/stow
./fedora-setup --only dotfiles/zsh
./fedora-setup --only packaging/base # Base packages
./fedora-setup --only packaging/flatpak # Flatpak apps
./fedora-setup --only packaging/rust # Rust tools
./fedora-setup --only config/git
./fedora-setup --only config/kde # KDE Plasma defaults
./fedora-setup --only config/services # Enable services
./fedora-setup --only config/performance # Performance tuning (zram, shutdown timeout)
./fedora-setup --only config/secureboot # Secure Boot setup
./fedora-setup --only config/hardware/asus # ASUS laptop (sleep hooks, GPU power)
./fedora-setup --only config/hardware/nvidia # NVIDIA drivers
./fedora-setup --only external/skillset # External repo (skillset)

Dotfiles Management

Selective Stowing

# Stow all packages
rig stow --all
# or: ./bin/rig-stow --all# Stow specific packages
rig stow config zsh # Only config and zsh# Adopt existing files (resolve conflicts)
rig stow --adopt config # Move existing files into dotfiles repo and stow# Restow (useful after updates)
rig stow -R config # Restow config
rig stow -R --all # Restow all

Manual Stow

cd~/.dotfiles
stow --no-folding --restow --target=$HOME home/config
stow --no-folding --restow --target=$HOME home/zsh

Package Management

Declarative (Recommended)

# macOS
rig add brew neovim # Add CLI tool
rig add cask firefox # Add GUI app
./macos-setup --only packaging/brew # Install new packages# Fedora
rig add base neovim # Add to base packages
rig add flatpak com.spotify.Client # Add Flatpak
./fedora-setup --only packaging/base # Install new packages

Interactive

rig pkg-manage

Reset/Re-run Components

rig reset

Interactive menu to reset specific components.

Web Applications (Fedora only)

# Install
rig webapp-install "App Name""https://example.com""icon.png"# Remove
rig webapp-remove ChatGPT # Specific app

Structure

.
├── unix/
│ ├── setup # Common entry point (OS detection)
│ ├── common/ # Cross-platform scripts
│ │ ├── bin/ # Shared CLI commands (rig-install-skillset)
│ │ ├── helpers/ # Logging, common functions
│ │ ├── dotfiles/ # Stow, fonts, zsh
│ │ ├── config/ # Git, NextDNS, Rust
│ │ └── external/ # External git repos (skillset)
│ ├── fedora/ # Fedora-specific setup
│ │ ├── bin/ # Fedora CLI commands (rig-add, rig-stow, ...)
│ │ ├── install/
│ │ │ ├── config/ # System config (KDE, hardware, performance)
│ │ │ ├── dotfiles/ # Dotfiles management
│ │ │ └── external/ # External repos
│ │ └── packages/ # Package lists
│ └── macos/ # macOS-specific setup
│ ├── bin/ # macOS CLI commands (rig-add, rig-stow, ...)
├── windows/ # Windows configuration (see windows/README.md)
├── default/ # Default configs (skills, wallpapers)
└── docs/ # Documentation

Features

Common (Both Platforms)

• Git & SSH: ed25519 keys with automatic configuration
• Shell: ZSH with zgenom plugin manager
• Dotfiles: GNU Stow for symlink management
• Fonts: Iosevka, CaskaydiaCove Nerd Font, Meslo Nerd Font, JetBrains Mono, Inter, Geist
• Rust: Rustup with configurable cargo tools
• NextDNS: Automated DNS configuration

Fedora-Specific

• KDE Plasma: Keybindings, Krohnkite tiling, theme defaults, KDE config symlink management
• KDE Config: Config files (kwinrc, kdeglobals, kglobalshortcutsrc, kwinrulesrc, plasmaparc) are symlinked via kde.sh so changes stay tracked in the repo
• Package Management: DNF optimization, Flatpak, Rust tools
• Repositories: RPM Fusion, COPR, Terra
• Web Applications: Twitter, ChatGPT (incognito), Grok (incognito)
• Hardware Support: ASUS laptops, NVIDIA drivers
• Performance: zram, fstrim, systemd-oomd
• Services: PostgreSQL, Redis, Docker
• Security: Firmware updates, Secure Boot

macOS-Specific

• Package Management: Homebrew, Cask, Rust tools
• Applications: CLI tools and GUI applications
• System: Hostname and system preferences

Declarative Configuration

Each platform has a config.json for declarative configuration:

• unix/macos/config.json - macOS configuration
• unix/fedora/config.json - Fedora configuration

Logs

Setup logs are stored at ~/.local/state/rig/install.log.

Check logs if something fails:

tail -50 ~/.local/state/rig/install.log

Documentation

• Fedora Setup Guide - Fedora-specific documentation
• macOS Setup Guide - macOS-specific documentation

License

CC0 1.0 Universal