Skip to content

AGENTS.md

Latest commit

 

History

History
41 lines (30 loc) · 1.85 KB

AGENTS.md

File metadata and controls

41 lines (30 loc) · 1.85 KB
Raw

Dotfiles Agent Guide

Personal dotfiles managed by chezmoi: shell, editor, AI-tool persona, Git/jj config, and supporting tooling for macOS and Linux.

Quick Facts

  • Languages: Shell (bash/zsh), Go text/template (chezmoi templating)
  • Manager: chezmoi (v2.62.1+); packages: Homebrew (dot_Brewfile.tmpl)
  • VCS: jj-first (Jujutsu), colocated with git; trunk: master
  • No CI, linters, or test framework — quality is verified via chezmoi diff/verify

Quick Commands

chezmoi diff            # preview pending changes (always before apply)
chezmoi apply           # deploy source state to ~/
chezmoi execute-template < file.tmpl   # test .tmpl rendering
brew bundle --global    # install packages after apply
task                    # list maintenance tasks (go-task)

Architecture at a Glance

  • AI persona is canonical at ~/.agents/AGENTS.md (source: dot_agents/AGENTS.md). No duplicated per-tool rule/agent/command content. Skills install from SystemFiles/skills, not from here.
  • Source naming uses chezmoi prefixes (dot_, private_, symlink_, run_), with .chezmoiignore (not deployed) and .chezmoiremove (deleted from ~/).

Sensitive Files

Never commit secrets. private_dot_ssh/ and private_dot_gnupg/ hold config templates only; machine-specific values are prompted at init time.

Detailed Instructions