Dotfiles

Personal configuration files for my development environment.

Contents

This repository contains configuration files for:

• Codex - Shared agent instructions installed to ~/.codex/AGENTS.md
• Agent skills - Installed to ~/.agents/skills by install-skills.sh, not stored in this repository
• WezTerm – Terminal emulator configuration
• Zsh – Shell configuration and customizations
• Claude Code - Skills folder linked to ~/.agents/skills
• Aerospace – Window manager workspace definitions
• SketchyBar – macOS status bar, items, and themes
• JankyBorders – Window border styling via borders.app
• Maccy – Lightweight clipboard manager

Structure

dotfiles/
├── aerospace/
│   └── .aerospace.toml                     # Aerospace workspace configuration
├── claude/
│   └── .claude/skills -> ~/.agents/skills  # Claude Code reads the shared skills
├── codex/
│   └── .codex/AGENTS.md                    # Shared Codex agent instructions
├── install-skills.sh                       # Optional. Installs the shared skills
├── jankyborders/
│   └── .config/borders/bordersrc           # Borders.app theme
├── sketchybar/
│   └── .config/sketchybar/…                # SketchyBar items, plugins, and themes
├── wezterm/
│   └── .wezterm.lua                        # WezTerm configuration
└── zsh/
    └── .zshrc                              # Zsh shell configuration

Installation

This repository uses GNU Stow for managing symlinks.

Quick Install (Recommended)

Clone this repository and run the installation script:

git clone https://github.com/Jcardif/dotfiles.git
cd dotfiles
chmod +x install.sh
./install.sh

Claude Code and Codex CLI are optional and are skipped by default. To install either one, pass the matching option; selected packages are also included in stow:

./install.sh --with-claude
./install.sh --with-codex
./install.sh --with-claude --with-codex

The installation script will:

• Install required Nerd Fonts (Meslo LG, JetBrains Mono, SF Pro)
• Install WezTerm terminal emulator
• Install Powerlevel10k theme
• Install Zsh plugins (autosuggestions, syntax-highlighting)
• Install modern CLI tools (eza, zoxide)
• Install GNU Stow for symlink management
• Install Aerospace window manager
• Install SketchyBar status bar
• Install Janky Borders (borders.app)
• Install Maccy clipboard manager
• Install GitHub CLI (gh)
• Install GitHub Copilot CLI
• Install Codex CLI, only when --with-codex is provided
• Install Claude Code, only when --with-claude is provided
• Install Aspire CLI
• Install dotnet-ef global tool (if dotnet is installed)
• Install Rust (via rustup)
• Create symlinks to your home directory, including optional packages only when selected

Agent skills (optional)

The shared agent skills are not stored in this repository. install-skills.sh downloads them with the skills CLI, and puts them in ~/.agents/skills. It then links the Claude Code and Codex skill folders to that one directory.

install.sh does not call this script. Run it by hand:

chmod +x install-skills.sh
./install-skills.sh

To add one more skill later, call the CLI directly:

npx skills add https://github.com/mattpocock/skills --skill wayfinder

The script does not replace ~/.claude/skills or ~/.codex/skills when either one is a real directory. Move the directory first, then run the script again.

Manual Installation

If you prefer to install components manually:

Prerequisites

Install GNU Stow:

# macOS
brew install stow

Setup

1. Clone this repository (anywhere you like, e.g., ~/source/repos/):

   git clone https://github.com/Jcardif/dotfiles.git
   cd dotfiles

2. Install the required packages (see the install.sh script for the complete list)

3. Use Stow to create symlinks to your home directory:

   # Install default configurations
   stow -vt ~ aerospace jankyborders wezterm zsh
   
   # Include optional Claude and Codex configurations if wanted
   stow -vt ~ aerospace claude codex jankyborders wezterm zsh

   # Or install specific configurations
   stow -vt ~ aerospace
   stow -vt ~ claude
   stow -vt ~ codex
   stow -vt ~ jankyborders
   stow -vt ~ wezterm
   stow -vt ~ zsh

   • -t ~ = target is your home folder (where symlinks will be created)
   • -v = verbose output so you can see what's happening

   claude and codex are optional stow packages. Include them only if you want those agent configurations linked.

   If ~/.claude/skills already exists as a regular directory or file, move or remove it before running stow with the claude package so it does not fail with conflicts.

   If ~/.codex/AGENTS.md already exists as a regular file, move or remove it before running stow so the codex package can create the symlink cleanly.

4. Restart your terminal or source the configurations:

   source ~/.zshrc

Uninstallation

To remove symlinks created by Stow:

cd /path/to/dotfiles
stow -Dvt ~ aerospace
stow -Dvt ~ claude
stow -Dvt ~ codex
stow -Dvt ~ jankyborders
stow -Dvt ~ wezterm
stow -Dvt ~ zsh

# Or uninstall all packages at once
stow -Dvt ~ aerospace jankyborders wezterm zsh

# Include optional Claude and Codex packages if you installed them
stow -Dvt ~ aerospace claude codex jankyborders wezterm zsh