This dotfiles repository provides a modern, productive, and visually appealing development environment for macOS. It brings together:

• Aerospace — i3-like tiling window manager for macOS
• Sketchybar — highly customizable status bar for macOS
• Zsh — main shell with Starship prompt using the Pastel Powerline preset
• Atuin — magical shell history with sync across machines
• Tmux — terminal multiplexing with Claude Code integration and process management
• Neovim with LazyVim — pre-configured, extensible code editing
• Ghostty — fast, native terminal emulator
• Claude Code — AI coding assistant with custom hooks and status line
• 1Password CLI — secrets injected at login via op inject
• Hiddenbar and Stats — menu bar and system monitoring

Example: Starship prompt (Pastel Powerline), Ghostty terminal, and Sketchybar on macOS.

• Getting Started
• What Each Install Script Does
• Secrets Management
• Tmux
• Claude Code Integration
• Cheatsheet
• My Mac Setup
• About Aerospace

The install script backs up existing configuration files, but read below before running it!

Requirements:

• Git
• Homebrew (macOS package manager)
• 1Password CLI (op) — for secrets injection

# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

git clone https://github.com/mehd-io/dotfiles ~/.dotfiles
cd ~/.dotfiles
./install.sh              # Core tools, symlinks, Ghostty, Starship, Hiddenbar, Stats, LazyVim, Atuin
./install_sketchybar.sh   # Sketchybar and dependencies
./install_aerospace.sh    # Aerospace window manager

After installation, you may want to:

1. Restart your terminal to apply all shell changes
2. Log out and back in for Aerospace to take effect
3. Configure Atuin by running atuin login to sync shell history across machines
4. Set up 1Password — create items referenced in zsh/env.tpl (see Secrets Management)

• Installs packages via Homebrew: neovim, tmux, tree, wget, zsh, curl, starship, atuin
• Symlinks configuration files:
  • ~/.zshrc, ~/.zprofile (Zsh)
  • ~/.tmux.conf, ~/.tmux.conf.local (Tmux)
  • ~/.tmux/pane-info.sh, open-url.sh, log-pane.sh (Tmux runtime scripts)
  • ~/.config/ghostty/config (Ghostty)
  • ~/.config/starship.toml (Starship)
  • ~/.config/atuin/config.toml (Atuin)
  • ~/.config/borders/bordersrc (Borders)
  • ~/.claude/settings.json (Claude Code hooks and status line)
• Installs macOS apps via Homebrew Cask: Ghostty, Hiddenbar, Stats
• Installs LazyVim (Neovim starter config)
• Sets Zsh as default shell

• Installs Sketchybar and dependencies (sf-symbols, jq, gh)
• Downloads and installs sketchybar-app-font (required for workspace app icons)
• Backs up existing config and symlinks new config
• Restarts Sketchybar service

• Installs Aerospace window manager
• Backs up existing config and symlinks new config

Environment variables (API keys, tokens) are injected at first login via 1Password CLI op inject. The template zsh/env.tpl contains op:// references that resolve at runtime and are cached for the session.

• Theme from gpakosz/.tmux, prefix remapped to backtick (`)
• Vim-style pane navigation (h/j/k/l)
• Pane borders show: git branch, listening ports, devcontainer status
• Process state written to /tmp/tmux-proc-state/ for tooling integration
• Auto-cleanup: when the last pane for a repo closes, orphaned processes and devcontainers are stopped

Claude Code is configured via claude/settings.json (symlinked to ~/.claude/settings.json).

claude-statusline.sh provides a compact status line showing: state icon, directory, git branch (with worktree detection), model, and context remaining.

See docs/cheatsheet.md for all keyboard shortcuts (tmux, neovim, zsh, Claude Code).

A comprehensive list of apps and tools I use for development and productivity.

I made a deep dive video on this tiling window manager:

This setup uses Starship with the Pastel Powerline preset for a modern, colorful, and informative shell prompt.