dots

dots

A dotfiles manager
for macOS & Linux.

One script installs everything. Symlinks, tools, configs, and a TUI to manage it all.

curl -fsSL https://raw.githubusercontent.com/CtrlUserKnown/dots/main/install.sh | sh

What you get

Everything wired up from the first run.

Interactive TUI

A ratatui-powered dashboard with 6 panes: symlinks, tools, plugins, configs, updates, and live network status. Supports keyboard and mouse.

Symlink management

Declare links in links.toml or use GNU Stow-style folding. Create and repair idempotently with automatic backups.

Cross-platform installs

One dependency list resolved per platform via Homebrew, apt, or dnf. Install required, optional, and dev tiers individually.

Premade configs

Bundled starter configs for Ghostty, Neovim, and opencode. Compiled into the binary — always available offline.

Network monitor

Live dashboard pane showing connectivity, latency, network name, DNS servers, and VPN status — platform-specific probes.

Portable profiles

Export your setup to personal.json and re-import it on another machine, locally or straight from GitHub.


The stack

Built in Rust. Tools managed on install.

Rust Single static binary with pure-Rust TLS
ratatui Terminal UI framework for the interactive dashboard
git Version control and self-updating
eza Modern ls replacement
fzf Fuzzy finder
bat Syntax-highlighted file previewer
zoxide Smarter cd
fastfetch System info on shell start

Ready to set it up?

Run the install script and you'll have a working dotfiles setup in a few minutes.