kdnk_obsidian-automatic-linker/AGENTS.md

# Agent Instructions

## Version Control

- Use `but` (GitButler CLI) for version-control operations in this repository.
- Use `but` for all version-control write operations; read-only `git` inspection is allowed.
- Do not access GitHub URLs directly. Use the `gh` CLI for GitHub operations.
- When committing, use English Conventional Commit messages and include a clear description of Why and What.
feat: add frontmatter opt-out for URL titles Why: - Some notes need to keep raw URLs and avoid web title requests even when global URL title replacement is enabled. - A per-note frontmatter flag gives users local control without disabling other automatic linking behavior. What: - Add automatic-linker-disable-url-title frontmatter detection. - Skip URL title fetching and replacement when the flag is set on a note. - Document the frontmatter option and add regression coverage for the helper and plugin flow. - Record this repository's agent version-control instructions in AGENTS.md. 2026-06-21 14:22:35 +00:00			`# Agent Instructions`

			`## Version Control`

docs: Update version control guidelines to use GitButler CLI Switches the recommended primary tool for version control operations from raw `git` commands to using `but` (GitButler CLI). This change ensures that all write operations, such as committing, are standardized and executed through the dedicated CLI. Read-only inspection via standard `git` remains allowed. 2026-07-19 08:26:21 +00:00			- Use `but` (GitButler CLI) for version-control operations in this repository.
			- Use `but` for all version-control write operations; read-only `git` inspection is allowed.
feat: add frontmatter opt-out for URL titles Why: - Some notes need to keep raw URLs and avoid web title requests even when global URL title replacement is enabled. - A per-note frontmatter flag gives users local control without disabling other automatic linking behavior. What: - Add automatic-linker-disable-url-title frontmatter detection. - Skip URL title fetching and replacement when the flag is set on a note. - Document the frontmatter option and add regression coverage for the helper and plugin flow. - Record this repository's agent version-control instructions in AGENTS.md. 2026-06-21 14:22:35 +00:00			- Do not access GitHub URLs directly. Use the `gh` CLI for GitHub operations.
			`- When committing, use English Conventional Commit messages and include a clear description of Why and What.`