dotfiles

Imported from codecio/dotfiles (AGENTS.md). Install upstream with npx skills add codecio/dotfiles. Copyright stays with the author.

Agent instructions (dotfiles)

Chezmoi-managed work-machine dotfiles for macOS (github.com/codecio/dotfiles). Windows 11 is a future apply path. This repo is the source of truth for shell, git, Homebrew splits, editor extension lists, and docs. It is not an application codebase.

Non-negotiables

• Edit chezmoi source under home/, then make apply. Do not edit live ~/.zshrc, ~/.gitconfig, or other applied files in place.
• Brewfile is dotfiles-required CLI only. Daily tools go in Brewfile.cli, GUI casks in Brewfile.apps.
• Extfile entries must resolve on both Microsoft Marketplace and OpenVSX, or make ext fails on one editor.
• Public repo. No employer hostnames, fleet IPs, or secrets in committed files.
• Do not add Cursor agent shell integration globally in home/dot_zshrc (network latency on every shell). See docs/shell.md.

Always-on guardrails also live in .cursor/rules/dotfiles.mdc (same content, rule injection).

First commands

make help      # all targets
make lint      # before commit (gitleaks, yaml, whitespace, …)
make apply     # after changing home/ templates
git status && git diff

Bootstrap and Brew splits: docs/bootstrap.md, docs/brew.md. Full doc index: docs/README.md.

Repo map (short)

Git identity is path-based (includeIf in home/dot_gitconfig.tmpl), not per laptop. Do not collapse work and personal profiles.

Machine-local only (not in git): ~/.zshenv.local, ~/.zshrc.local.

Continuing from a prior session

Models do not retain memory between chats. Use repo files first, then attach prior context.

1. Read this file and .cursor/rules/dotfiles.mdc.
2. Reconstruct state from git (git status, git log -5, git diff vs main). Treat the branch and commits as authoritative over chat summary.
3. Optional prior context: @Chats for a previous Cursor thread, or invoke @handoff (personal skill under ~/.cursor/skills/handoff after make apply) for a compact handoff doc.
4. For structured resume in this repo, run /resume-dotfiles (project skill in .cursor/skills/resume-dotfiles/).
5. For rigorous multi-step work, start with /poteto-mode (pstack plugin). Session pickup playbook lives in pstack; before pausing long work, use pstack pause safely (wip: commit + /tmp/<slug>-resume.md).

Do not redo work already landed on the branch unless verification failed on the real artifact (make apply, make lint, or the behavior under change).

Common tasks

Before you commit

Only commit when the user asks. When they do:

make lint
make apply

Pre-commit runs secret scanning. Do not skip hooks unless the user explicitly requests it.