Skip to content

README.md

Latest commit

 

History

History
96 lines (75 loc) · 3.17 KB

README.md

File metadata and controls

96 lines (75 loc) · 3.17 KB

dotfiles

macOS dev environment: zsh, terminals, editors, AI coding agents.

setup

git clone https://github.com/pratapyash/dotfiles.git ~/dotfiles
cd ~/dotfiles
./bootstrap.sh     # creates symlinks, sets up secrets file
source ~/.zshrc

dependencies

# required
brew install starship zsh-autosuggestions tree bat fd eza fzf

# terminals (optional)
brew install --cask cmux        # AI agent terminal (ghostty-based)
brew install --cask iterm2

# cloud (optional)
brew install awscli
brew install --cask google-cloud-sdk

what's included

shell (zsh/)

File Purpose
.zshrc core init: completion, keybindings, starship, conda, PATH
aliases.zsh git, directory, eza, fzf, navigation shortcuts
tools.zsh terminal launchers, AWS EC2, cmux functions
.zshrc.secrets credentials -- gitignored, created from template by bootstrap

cmux functions (tools.zsh)

Command Description
cx [path] cmux workspace: claude + shell
cxa [path] cmux workspace: 3 claude agents in split panes
cxc [path] incremental: named workspace, pick from registry, split or tab
cxm migrate running iTerm claude sessions to cmux (by session ID)
cxr interactive workspace registry manager (fzf)

terminals

Dir What
ghostty/ catppuccin mocha, transparency, monaco font
cmux/ workspace registry template, setup defaults
iterm2/ profiles, global prefs, keymaps, snippets, colors (allowlist export)

editors & tools

Dir What
cursor/ settings, keybindings
claude/ global CLAUDE.md (gitignored), settings, agents, commands
starship/ prompt theme config

structure

zsh/.zshrc                      shell init
zsh/aliases.zsh                 aliases + navigation
zsh/tools.zsh                   terminal launchers, cloud, cmux
zsh/.zshrc.secrets.template     credentials template
ghostty/config                  terminal appearance
cmux/registry.json.template     workspace registry template
cmux/setup-defaults.sh          cmux preferences checklist
iterm2/profiles/*.json          iterm2 profiles (DynamicProfiles format)
iterm2/prefs.xml                iterm2 global prefs (allowlisted)
iterm2/snippets.plist           iterm2 snippets
iterm2/colors/                  iterm2 color presets
iterm2/export.py                snapshot live iterm2 -> tracked files
iterm2/install.sh               restore on fresh machine
iterm2/hooks/pre-commit         leak-scanner hook (core.hooksPath)
cursor/settings.json            editor settings
cursor/keybindings.json         editor keybindings
claude/settings.json            claude code config
claude/agents/*.md              custom subagents
claude/commands/*.md             custom slash commands
starship/starship.toml          prompt config
bootstrap.sh                    symlink setup + security

secrets

Credentials live in zsh/.zshrc.secrets (gitignored). Bootstrap creates it from the template. Contains AWS SSH paths, EC2 instance details, and GCP credentials path.

cmux/registry.json is also gitignored (machine-specific project paths).