My Dotfiles

These are my personal dotfiles for macOS development environments. They provide a consistent setup across machines with automated configuration.

Key Tools

CLI

direnv: Securely loads or unloads environment variables depending on the current directory
Homebrew: Package management for macOS
Homesick: Manages dotfiles with Git and symlinks
Just: 🤖 Command runner for project-specific tasks
Starship: Minimal, blazing-fast, and customizable prompt for any shell

GUI

Alfred: Productivity tool with Alfred Powerpack
Hammerspoon: macOS automation tool (tiling windows manager)

Python Environment

pip: PyPA recommended tool for installing Python packages
pyenv: Simple Python version management
uv: Fast Python package installer and resolver, written in Rust

Installation

Install Homesick:
```
$ gem install homesick
```
Clone this repository:
```
$ homesick clone jefftriplett/dotfiles
```
Create the symlinks:
```
$ homesick symlink dotfiles
```

Bootstrap the environment:

$ just --justfile=./home/justfile bootstrap

Project Workflow (Just)

Most tasks in this repo run via just recipes defined in home/justfile and its submodules in home/.justfiles. Use just --justfile=./home/justfile when running commands from the repo root.

Common commands:

$ just --justfile=./home/justfile install
$ just --justfile=./home/justfile bootstrap
$ just --justfile=./home/justfile update
$ just --justfile=./home/justfile update-readme-docs

Project Shell

project-shell uses per-project direnv config to attach to the right tmux session locally or over Mosh:

$ project-shell

Example work-project .envrc:

export PROJECT_REMOTE_HOST=mac-studio
export PROJECT_REMOTE_NAME=mac-studio
export PROJECT_TMUX_SESSION=my-work-project
export PROJECT_REMOTE_MODE=auto

Example personal-project .envrc:

export PROJECT_REMOTE_HOST=mac-mini
export PROJECT_REMOTE_NAME=mac-mini
export PROJECT_TMUX_SESSION=my-home-project
export PROJECT_REMOTE_MODE=auto

Run direnv allow after creating or changing a project .envrc. Set PROJECT_REMOTE_CONNECT_TIMEOUT to override the default five-second SSH connection timeout used by Mosh startup.

Modes are auto, remote, local, and off. auto uses Mosh when PROJECT_REMOTE_HOST is set, avoids connecting to the current machine, and falls back to local tmux if no remote is configured. Failed remote attempts ask whether to use local tmux, retry, or abort.

Justfile Usage

$ just --justfile=./home/justfile --list --list-submodules

Available recipes:
    homebrew:
        cleanup DAYS="0" # clean up old Homebrew packages and cache
        freeze           # freeze current Homebrew packages to Brewfile
        outdated         # list outdated Homebrew packages
        services         # list all Homebrew services
        services-restart # restart all running Homebrew services
        services-stop    # stop specific Homebrew services (with non-fatal errors)
        update           # update Homebrew package database
        upgrade          # upgrade all outdated Homebrew packages
    llm:
        fmt      # format all AI/LLM justfiles
        outdated # check for outdated AI/LLM tools
        upgrade  # upgrade all AI/LLM tools
        claude:
            config  # open Claude Desktop configuration file in Sublime Text
            install # install Claude Code CLI
            upgrade # update Claude Code CLI to the latest version
            usage   # see Claude Code API/CLI usage
            version # display Claude Code CLI version

        clawdbot:
            doctor    # run clawdbot doctor to check configuration
            health    # check clawdbot health status
            install   # install clawdbot CLI
            restart   # restart clawdbot daemon
            uninstall # uninstall clawdbot CLI
            upgrade   # upgrade clawdbot to the latest version
            version   # display clawdbot version

        clawdhub:
            install   # install clawdhub CLI
            uninstall # uninstall clawdhub CLI
            upgrade   # upgrade clawdhub to the latest version
            version   # display clawdhub version

        codex:
            config    # open Codex configuration file in Sublime Text
            install   # install Codex CLI
            uninstall # uninstall Codex CLI
            upgrade   # update Codex CLI to the latest version
            usage     # see Codex CLI usage
            version   # display Codex CLI version

        copilot:
            config    # open Copilot configuration file in Sublime Text
            outdated  # check for outdated Copilot npm package
            uninstall # uninstall Copilot CLI
            upgrade   # update Copilot CLI to the latest version
            version   # display Copilot CLI version

        glm:
            install   # install ccx CLI
            uninstall # uninstall ccx CLI
            upgrade   # update ccx CLI to the latest version
            usage     # show available ccx model usage
            version   # display ccx CLI version

        happy:
            install   # install happy-coder CLI
            run       # run happy CLI
            uninstall # uninstall happy-coder CLI
            upgrade   # upgrade happy-coder to the latest version
            version   # display happy-coder version

        llm-cli:
            force-reinstall # upgrade all installed LLM plugins with --force-reinstall
            install *ARGS   # install LLM plugins with optional arguments
            path            # open LLM templates directory in Sublime Text
            upgrade         # upgrade all installed LLM plugins

        moltbot:
            doctor    # run moltbot doctor to check configuration
            health    # check moltbot health status
            install   # install moltbot CLI
            restart   # restart moltbot daemon
            uninstall # uninstall moltbot CLI
            upgrade   # upgrade moltbot to the latest version
            version   # display moltbot version

        ollama:
            copy-plist  # copy custom ollama plist file to homebrew directory
            diff-plist  # compare local ollama plist with installed version
            download    # download various ollama models (- prefix makes failures non-fatal)
            getenv      # display ollama environment variables from launchctl
            list        # list all downloaded ollama models
            serve *ARGS # serve ollama in a tandem process with optional arguments
            setenv      # set ollama environment variables in launchctl

        openclaw:
            doctor    # run openclaw doctor to check configuration
            health    # check openclaw health status
            install   # install openclaw CLI
            restart   # restart openclaw daemon
            uninstall # uninstall openclaw CLI
            upgrade   # upgrade openclaw to the latest version
            version   # display openclaw version

        pi-coding-agent:
            help              # display pi CLI help
            install           # install pi-coding-agent CLI
            list-models *ARGS # list available models
            resume            # resume a previous pi session
            uninstall         # uninstall pi-coding-agent CLI
            upgrade           # upgrade pi-coding-agent to the latest version
            version           # display pi-coding-agent version
    macos:
        timemachine-boost          # boost Time Machine backup speed by increasing IO priority
        timemachine-boost-complete # restore normal IO priority after Time Machine backup completes
        timemachine-delete *ARGS   # delete specific Time Machine backups
        timemachine-list           # list all Time Machine backups
        xcode-bootstrap            # install Xcode command line tools
        xcode-upgrade              # upgrade Xcode command line tools by removing and reinstalling
    mise:
        bootstrap # bootstrap mise by installing configured language versions
        upgrade   # install latest language versions and refresh shims
    pyenv:
        upgrade +ARGS="--skip-existing"     # upgrade all python versions managed by pyenv
        upgrade-all +ARGS="--skip-existing" # install or upgrade all python versions managed by pyenv
    python:
        bootstrap                 # bootstrap python environment with essential packages
        outdated                  # list outdated Python packages
        upgrade                   # update python environment
        uv-pip-install *ARGS      # install python packages using uv pip installer
        uv-pip-uninstall *ARGS    # uninstall python packages using uv pip installer
        uv-pip-upgrade *ARGS      # update python versions using uv installer
        uv-python-install *ARGS   # install python versions using uv installer
        uv-python-reinstall *ARGS # reinstall python versions using uv installer
        uv-tool-install *ARGS     # install common python CLI tools using uv installer
        uv-tool-upgrade           # upgrade common python CLI tools using uv installer
    virtualenv:
        scan    # scan virtualenvs and display their python versions
        upgrade # upgrade pip in all virtualenvs
        workon  # list all virtualenvs with their python and pip versions
    virtualenvwrapper:
        get_env_details  # virtualenvwrapper hook for getting environment details
        initialize       # virtualenvwrapper hook for environment initialization
        postactivate     # virtualenvwrapper hook that runs after environment activation
        postdeactivate   # virtualenvwrapper hook that runs after environment deactivation
        postmkproject    # virtualenvwrapper hook that runs after creating a project
        postmkvirtualenv # virtualenvwrapper hook that runs after creating a virtualenv
        postrmproject    # virtualenvwrapper hook that runs after removing a project
        postrmvirtualenv # virtualenvwrapper hook that runs after removing a virtualenv
        preactivate      # virtualenvwrapper hook that runs before environment activation
        predeactivate    # virtualenvwrapper hook that runs before environment deactivation
        premkproject     # virtualenvwrapper hook that runs before creating a project
        premkvirtualenv  # virtualenvwrapper hook that runs before creating a virtualenv
        prermproject     # virtualenvwrapper hook that runs before removing a project
        prermvirtualenv  # virtualenvwrapper hook that runs before removing a virtualenv

    [database]
    postgresql-upgrade # upgrade PostgreSQL to latest version and migrate databases

    [maintenance]
    cleanup DAYS="0"   # clean up old Homebrew packages and casks
    outdated           # list outdated packages from Homebrew and pip
    update             # update project to run at its current version
    upgrade            # update and upgrade Homebrew packages
    upgrade-all        # upgrade all tools (pyenv and mise packages)

    [services]
    restart            # restart Homebrew services
    stop               # stop all Homebrew services

    [setup]
    bootstrap          # install and update all dependencies
    install            # create symlinks for dotfiles using homesick

    [shortcuts]
    open-docs          # open documentation in browser using Tailscale/golinks
    open-go            # open Tailscale/golinks homepage
    open-ha            # open Home Assistant interface in browser
    open-syncthing     # open Syncthing interface in browser

    [utils]
    fmt                # format and overwrite justfile
    freeze             # update lockfiles without installing dependencies [alias: lock]
    lint               # run shellcheck on bash configuration files
    test               # run validation checks
    update-brewfile    # update Brewfile from cog template
    update-readme-docs # update README.md docs using cog

Hammerspoon Keyboard Shortcuts

Modifiers

Name	Key Combination
hyper	`ctrl` + `opt` + `cmd`
meta	`cmd` + `shift`

Window Management

Action	Key Combination
reload config	`hyper` + `r`
show grid	`hyper` + `g`
make full screen	`hyper` + `m`
center and 60%	`hyper` + `c`
move to left half	`hyper` + `left`
move to right half	`hyper` + `right`
move to top half	`hyper` + `up`
move to lower half	`hyper` + `down`
move to upper left (25%)	`ctrl` + `opt` + `shift` + `left`
move to upper right (25%)	`ctrl` + `opt` + `shift` + `up`
move to lower left (25%)	`ctrl` + `opt` + `shift` + `down`
move to lower right (25%)	`ctrl` + `opt` + `shift` + `right`
move to next monitor	`ctrl` + `opt` + `right`
move to previous monitor	`ctrl` + `opt` + `left`

Display Grid (2x2 Monitor Setup)

Action	Key Combination
fix 2x2 display grid	`hyper` + `f`
dump display configuration	`hyper` + `9`

Application Toggle

Action	Key Combination
iTerm2	`hyper` + `i`
Discord	`hyper` + `d`
Slack	`hyper` + `s`
Telegram	`hyper` + `t`
Sublime Text	`hyper` + `e`
Tower	`hyper` + `w`
Zed	`hyper` + `x`
Messages	`hyper` + `a`
Vivaldi	`hyper` + `v`
Obsidian	`hyper` + `o`

Utilities

Action	Key Combination
window hints (current app)	`hyper` + `.`
battery/screen callbacks	`hyper` + `,`
display watcher status	`hyper` + `0`

tmux Setup

Session management and key bindings are defined in home/.tmux.conf and home/.bash_tmux.

Shell Aliases

Alias	Command	Description
`t`	`tmux`	Run tmux
`ta [name]`	`tmux-go`	Attach to or create a named session
`tn [name]`	`tmux-new`	Create a new session (attaches if it already exists)
`tr [name]`	`tmux-resume`	Alias for `tmux-go`
`tk [name]`	`tmux-kill`	Kill a named session
`tls`	`tmux-ls`	List all sessions

Tab completion for session names is available on ta, tr, tn, and tk.

Key Bindings

Prefix is Ctrl-b.

Panes

Action	Key
Split horizontally	`prefix + \|`
Split vertically	`prefix + -`
Navigate left/down/up/right	`prefix + h/j/k/l`
Resize left/down/up/right	`prefix + H/J/K/L` (repeatable)

Windows

Action	Key
New window (current directory)	`prefix + c`

Copy Mode

Action	Key
Enter copy mode	`prefix + [`
Start selection	`v`
Copy selection to clipboard	`y`
Mouse drag	auto-copies to clipboard

Misc

Action	Key
Reload config	`prefix + r`
Clear screen and scrollback	`prefix + Ctrl-k`

direnv Auto-Attach

Add use tmux to any project's .envrc to automatically attach to (or create) a tmux session when entering that directory:

# .envrc
use tmux                                          # session name defaults to the directory name
use tmux myproject                                # explicit session name
use tmux myproject --machine myserver             # SSH to a remote host's tmux session
use tmux myproject --machine myserver --path /home/jeff/projects/myproject  # with a remote start path

Set NO_TMUX_AUTOATTACH=1 to skip auto-attach for a shell session.

Environment Variables

These variables are exported by use tmux in .envrc and read by the shell functions in home/.bash_tmux. They can also be set manually without direnv.

Variable	Description
`TMUX_AUTOATTACH`	Session name to attach to or create on shell startup
`TMUX_AUTOATTACH_MACHINE`	SSH hostname to route all tmux commands through
`TMUX_AUTOATTACH_HOST`	Alias for `TMUX_AUTOATTACH_MACHINE`
`TMUX_AUTOATTACH_PATH`	Working directory passed to `tmux new-session -c` (creation only, not re-attach)
`NO_TMUX_AUTOATTACH`	Set to `1` to disable auto-attach for a shell session

Remote Sessions

Set --machine (or --host / --profile) to SSH into a remote host's tmux session instead of the local one. All commands — tmux-go, tmux-ls, tmux-kill, and auto-attach — are routed through ssh -t automatically.

# .envrc
use tmux myproject --machine myserver

# With a starting directory on the remote host (only applies when creating a new session)
use tmux myproject --machine myserver --path /home/jeff/projects/myproject

Requires key-based SSH auth (no password prompt) since the connection is non-interactive.

Terminal theme

Dracula Dark theme for iTerm and 294+ apps.

Repository Layout

home/: dotfiles (Brewfile, shell config, app config)
home/.justfiles/: just submodules for task groups
configs/: editor/application configs (Sublime Text)
scripts/: README generation helpers

Inspiration / Thank you!

Contact / Social Media

Here are a few ways to keep up with me online. If you have a question about this project, please consider opening a GitHub Issue.

Name		Name	Last commit message	Last commit date
Latest commit History 1,143 Commits
.github/workflows		.github/workflows
configs/sublime_text		configs/sublime_text
home		home
scripts		scripts
.chezmoiroot		.chezmoiroot
.editorconfig		.editorconfig
.gitignore		.gitignore
.homesick_subdir		.homesick_subdir
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
homeslice.toml		homeslice.toml
sync-stignore.sh		sync-stignore.sh

Folders and files

Latest commit

History

Repository files navigation

My Dotfiles

Key Tools

CLI

GUI

Python Environment

Installation

Project Workflow (Just)

Project Shell

Justfile Usage

Hammerspoon Keyboard Shortcuts

Modifiers

Window Management

Display Grid (2x2 Monitor Setup)

Application Toggle

Utilities

tmux Setup

Shell Aliases

Key Bindings

Panes

Windows

Copy Mode

Misc

direnv Auto-Attach

Environment Variables

Remote Sessions

Terminal theme

Repository Layout

Inspiration / Thank you!

Contact / Social Media

About

Topics

Resources

License

Code of conduct

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages