Skip to content

AGENTS.md

Latest commit

 

History

History
43 lines (32 loc) · 2 KB

AGENTS.md

File metadata and controls

43 lines (32 loc) · 2 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)
task skills:sync        # add locally-installed skills to skills-registry.txt

Architecture at a Glance

  • AI persona is canonical at ~/.agents/AGENTS.md (source: dot_agents/AGENTS.md); ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md are symlink shims to it. No duplicated per-tool rule/agent/command content. Skills are declared in skills-registry.txt and installed by a run_ script via the skills CLI.
  • 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