daviddwlee84/dotfiles¶
Cross-platform development environment setup using chezmoi (config files) + ansible (system dependencies), tuned for coding-agent workflows on macOS and Ubuntu.
For the quick-install path, supported platforms table, and the "what do I get" bullet list, read README.md on GitHub — it's the canonical first stop and deliberately left as the single source of truth (not duplicated into this site).
Where to read next¶
For users adopting a slice¶
| I want to… | Start here |
|---|---|
| Pipe my shell scrollback through Claude / OpenCode / Codex | aicapture |
| Understand the tmux config (popup menu, OSC 133, copy-mode) | tmux |
| Get tmux keybindings at a glance | tmux keybindings |
| See every custom zsh alias / function | zsh aliases |
| Sesh session workflow (shere / sroot / scode / svibe) | sesh · workflow playbook |
| Set up the agent CLIs (claude / opencode / codex / cursor) | agent overlays |
Clipboard over SSH (OSC 52, x copy, Neovim integration) |
clipboard |
For maintainers¶
| I want to… | Start here |
|---|---|
| Understand the architecture | architecture |
Multi-host apply / fleet-apply |
fleet-apply |
| The testing / linting / pre-commit story | testing · pre-commit |
| Upgrades split from installs | upgrades |
| chezmoi conventions (prefixes, templating, scripts layout) | chezmoi prefixes · chezmoi templating · chezmoiscripts layout |
| The repo's design-space research (why we built what we built) | instant-LLM-fix prior art |
Repo-maintainer surfaces¶
TODO.md, backlog/, pitfalls/, CLAUDE.md — these are agent-facing maintenance surfaces, not user documentation. They're linked from the site for discoverability but live at the repo root; see For Maintainers.
Trying it without adopting the whole repo¶
Each tool page that's self-contained (e.g., aicapture) has a "Standalone setup" section with curl commands + ~/.zshrc snippet you can paste into any zsh environment without cloning the whole dotfiles repo.
Site conventions¶
- All source-of-truth content lives under
docs/in the repo. The GitHub blob URL for any page is a valid alternative to this site. - The
Copy to LLMbutton on the top right of each page dumps the current page into a paste-ready format (works with Claude Codeclaude -p/ OpenCodeopencode run/ pbcopy). - llms.txt / llms-full.txt are auto-generated site-wide manifests for agents.