This repository contains my personal dotfiles: shell, editor, terminal, and supporting scripts used on my development machines.
dotfiles/
├── shell/ # Shell configuration and environment setup
├── editor/ # Editor configuration (nvim/)
├── terminal/ # Terminal emulator configuration (ghostty/, kitty/, konsole/)
├── fonts/ # Font assets
├── voice/ # Speech-to-text input
└── bosun/ # Opt-in Bosun installer (private releases)
Each top-level directory has a distinct responsibility. The intent is to keep these responsibilities separate so that changes in one area do not cascade unnecessarily into others.
Shell initialization and environment wiring.
Typical contents:
- shell init files
- aliases and functions
- environment variables
- toolchain setup
This directory defines how commands execute and how the environment behaves.
Editor configuration.
Typical contents:
- Neovim configuration (
nvim/, built on LazyVim) - editor-specific keybindings
- editor plugins and settings
This directory is editor-specific and intentionally isolated from shell logic.
Terminal emulator configuration.
Typical contents:
- Ghostty, Kitty, and Konsole configs (
terminal/ghostty/,terminal/kitty/,terminal/konsole/) - terminal appearance and behavior settings
This directory affects how terminals look and behave, not what they execute.
./install.sh installs one terminal config. Choose it with
--terminal=ghostty|kitty|konsole|none or DOTFILES_TERMINAL=...;
otherwise it uses Konsole on Linux and, on macOS, Ghostty if installed,
then Kitty. To switch later, run that terminal's installer directly,
e.g. bash terminal/kitty/install.sh.
On macOS the installer uses no Homebrew, Xcode Command Line Tools, or
conda. Every tool is a prebuilt binary installed with
mise into your home directory
(~/.config/mise/config.toml lists them), and re-running the installer
bumps them all to their latest releases.
git is GitHub Desktop's relocatable build (dugite-native). Nothing in this repo compiles code on macOS, so no C toolchain is installed.
A fresh Mac has no git (/usr/bin/git only offers to install the Xcode
tools), so bootstrap from a tarball, then switch to a real clone:
curl -fsSL https://github.com/justapithecus/dotfiles/archive/main.tar.gz | tar xz
./dotfiles-main/install.sh
# new shell: git now comes from mise
git clone git@github.com:justapithecus/dotfiles ~/workspace/justapithecus/dotfiles
rm -rf dotfiles-mainFont assets used by the terminal and editor configurations.
Opt-in installer for Bosun, which runs
a repository's development process. Its releases are private, so
./install.sh installs it only with --with-bosun or DOTFILES_BOSUN=1.
bosun.yaml configures it for this repository and does nothing without it.
- This repository is personal and opinionated.
- It is not intended to be a reusable dotfiles template.
- Structure matters more than polish.