Concepts
Bundle OKF 0.1 · 5 conceitos · guumaster/dotfiles
Open source Repository Open in the app JSON README (API)
About
# Concepts
* [macOS Bootstrap](macos.md) - Setting up a new Mac with Homebrew, Brewfile, and dotfiles
* [Bare Repo Setup](setup.md) - How to clone, install, and manage dotfiles via a bare git repo with the config alias, and local overrides
* [SSH Identities](ssh.md) - Managing multiple SSH keys for personal and work GitHub accounts
* [Software Stack](tools.md) - Current CLI tools, shell config, and apps managed by dotfiles
* [Agent Guide](agent-guide.md) - How AI agents work with this repo — bare repo quirks, sparse checkout, SSH identity
Details
- Kind
- OKF bundles
- Topic
- Developer tools
- Publisher
- guumaster
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Stars
- 2
- Last push
- 2026-07-23T13:04:37Z
- Repository state
- ativo
- Language
- Shell
- Added
- 2026-09-08 09:02:43
- Updated
- 2026-09-08 09:02:43
- Origin id
guumaster/dotfiles:dotfiles/docs/index.md
README
# guumaster/dotfiles Personal dotfiles for macOS — shell, editor, terminal, git, and system configs managed via a bare git repo. ## What's here **Shell** — Zsh with Zinit plugin manager, Starship prompt, modular setup (aliases, exports, functions) **Terminal** — Ghostty config, htop, btop, bat, eza, fd, ripgrep, fzf **Git** — delta diff pager, lazygit TUI, global gitignore, custom aliases **Editor** — Neovim with vim-plug **macOS** — Homebrew Brewfile (150+ packages, casks, Go/uv/npm tools), bootstrap scripts **Docs** — full references under [dotfiles/docs/](dotfiles/docs/): | Doc | Covers | |-----|--------| | [Setup](dotfiles/docs/setup.md) | How the bare repo works — clone, alias, commands | | [Tools](dotfiles/docs/tools.md) | Tracked configs by category | | [macOS Bootstrap](dotfiles/docs/macos.md) | New Mac setup step by step | | [SSH Identities](dotfiles/docs/ssh.md) | Multi-key setup for personal + work | ## Quick start ```bash git clone --bare git@github.com-guuster:guumaster/dotfiles.git ~/.dotfiles.git alias config='git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME' config checkout config config status.showUntrackedFiles no ``` Add the `config` alias to your `.zshrc`, then: ```bash config status # see tracked files config add <file> # track a new config config diff # review changes config commit -m "…" config push ``` ## New Mac setup ```bash # 1. Clone and check out git clone --bare git@github.com-guuster:guumaster/dotfiles.git ~/.dotfiles.git git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME checkout git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME config status.showUntrackedFiles no # 2. Install packages (requires Homebrew) brew bundle --file ~/dotfiles/Brewfile ``` See [dotfiles/docs/macos.md](dotfiles/docs/macos.md) for the full guide, including SSH setup and post-install steps. ## How it works This repo uses a **bare git clone** with `$HOME` as the working tree. Files stay at their native OS paths — no symlinks, no wrappers. The `config` alias lets you run git commands against `$HOME/.dotfiles.git` from anywhere. Set `status.showUntrackedFiles = no` so `config status` only shows files you've explicitly added.