Personal configuration for a macOS development environment, stored in ~/.config.
This repository tracks selected settings and scripts; many local application
directories, credentials, and runtime files are excluded by .gitignore.
| Path | Purpose |
|---|---|
ghostty/ |
Ghostty settings, themes, and a TUIOS session launcher with tests. |
tuios/ |
TUIOS appearance, dock, sidebar, startup settings, and themes. |
nvim/ |
LazyVim-based Neovim configuration, language tooling, custom scripts, and tests. |
mpv/ |
Playback settings, uosc controls, thumbfast thumbnails, and bundled assets. |
codex/ |
Agent instructions, example configuration, hooks, and keybindings. |
claude/ |
Claude Code instructions and settings. |
git/ignore |
Shared Git ignore patterns. |
AGENTS.md, CLAUDE.md |
Repository instructions for coding agents. |
Back up existing configuration before copying files into ~/.config. Install
the applications you intend to use, then copy or symlink their directories from
this checkout. There is no installation script or complete dependency manifest.
The terminal setup assumes macOS, zsh, and this checkout at ~/.config; paths
resolve from $HOME, so it works under any account. The Ghostty launcher runs
with Homebrew's python3 when installed, otherwise the system python3.
ghostty/tuios-launcher.py expects a TUIOS wrapper at ~/.local/bin/tuios. That
wrapper is outside this repository; provide it locally or point the launcher at
your TUIOS executable.
Neovim bootstraps lazy.nvim and installs the configured plugins on first launch,
which requires Git and network access. Language-specific features may require
additional tools; inspect nvim/lazyvim.json and nvim/lua/plugins/ for the
enabled integrations.
codex/config.example.toml is a reference configuration. Review and adapt it
before creating a local codex/config.toml, which is intentionally ignored.
Review agent settings and hooks before enabling them on a new machine.
To use the shared Git ignore file, configure its location explicitly:
git config --global core.excludesFile "$HOME/.config/git/ignore"Ghostty launches TUIOS automatically. The launcher reuses the most recently active detached session, creates a session when all existing sessions are attached, and attempts to restore saved sessions when the daemon is stopped. A file lock serializes session selection and attachment across simultaneous launches.
Ghostty and TUIOS use Catppuccin Frappe. TUIOS starts tiled in terminal mode, with
the dock at the top and the sidebar on the left. The leader key is Ctrl+Space;
follow it with s for the session switcher or uppercase S for scrollback.