39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# AGENTS.md
|
|
|
|
Guidance for AI agents working in this repo. See README.md for full documentation.
|
|
|
|
## What this is
|
|
|
|
chezmoi source state. Files here deploy to `$HOME` (`~/.local/share/chezmoi` → `/home/pmcc`).
|
|
**Edit files here, never the live copies under `~/`.**
|
|
|
|
## Naming conventions
|
|
|
|
| Pattern | Effect |
|
|
|---|---|
|
|
| `dot_foo` | deploys as `.foo` |
|
|
| `executable_*` | deployed with +x |
|
|
| `*.tmpl` | rendered as Go template, deployed minus suffix |
|
|
| `.chezmoitemplates/` | shared fragments, never deployed |
|
|
| `.chezmoiignore.tmpl` | target-path ignore patterns, never deployed |
|
|
|
|
Templates that render to empty output are **not deployed** — this is intentional, don't "fix" it.
|
|
|
|
## Per-host config
|
|
|
|
Hosts: `flow` (desktop), `gata` (desktop/work), `framework13pro` (laptop).
|
|
`.chezmoi.toml.tmpl` maps hostname → `hosttype` data var. Branch templates on
|
|
`.chezmoi.hostname` or `.hosttype`. `.chezmoiignore.tmpl` scopes app configs per host
|
|
(pulsemeeter → flow only, teams-for-linux → desktops).
|
|
|
|
## Rules
|
|
|
|
- No secrets in this repo
|
|
- Verify before applying:
|
|
- `chezmoi diff` — preview target changes
|
|
- `chezmoi execute-template --init < file.tmpl` — render one template
|
|
- `chezmoi apply --destination /tmp/test` — render everything to a scratch dir
|
|
- `chezmoi status` — pending changes
|
|
- Workflow: edit source → `chezmoi diff` → `chezmoi apply -v` → commit/push from this dir
|
|
- `chezmoi re-add <path>` pulls live-edited files back into source
|