Agentlink is a small Go CLI that keeps AI coding-tool instruction files synchronized by making one user-chosen file authoritative and linking each tool-specific alias to it with ordinary filesystem symlinks.
AI coding tools read different filenames and global paths. Copying or regenerating the same instructions creates drift, hides ownership, and makes edits expensive. Agentlink keeps the mechanism inspectable: one real file, explicit configured links, no template engine, and no content transformation.
- One real source file owns instruction content.
- Agentlink links files; it does not generate or transform their contents.
- Dry-run must faithfully preview every filesystem mutation.
- Regular files are replaced only through an explicit backup or force choice.
- Directories and special files are never recursively replaced.
- Broken or unrelated links are not removed when ownership cannot be established.
- Errors preserve enough cause to distinguish invalid configuration, filesystem failure, unsupported layout, and external infrastructure.
- Project and global configuration remain separate and explicit.
- Release preparation is deterministic and mutation-free outside ignored build output; publication is a separate operation.
- Upstream attribution remains visible in NOTICE, README, repository history, and public metadata.
In scope: instruction-file discovery, explicit symlink configuration, synchronization, checking, cleanup of verified managed links, tool detection, repository scanning, and opt-in local hooks.
Out of scope: MCP configuration, prompt templating, content generation, content translation, secret management, remote execution, and ownership of the AI tools whose files Agentlink links.
N/A because Agentlink is a utility, not an open specification. Public claims are still treated as testable contracts and must have deterministic evidence or an explicit unautomated gap.
N/A as an open-spec requirement. Product changes are admitted only when they preserve the design invariants, add discriminating tests for repeatable failure modes, keep documentation and release surfaces aligned, and pass the release checklist.
Agentlink publishes a GuideCheck assistant guide for bounded installation and repository-verification actions. It uses the portfolio accessibility and search-contract methods for its hosted site. These integrations do not expand Agentlink's runtime scope.
docs/llms-full.txtis omitted becausedocs/llms.txtis a concise index of the product and its five public HTML pages. The homepage holds the generated support listing and links to three task guides and the integration reference. These linked HTML pages provide full detail; a second concatenated copy is omitted to avoid content drift. Reassess if machine consumers cannot follow these links.- Agentlink is a standalone maintained continuation rather than a GitHub-native fork. Fork-tier lineage rules still apply through the upstream remote, NOTICE, README credit, and canonical module path.
- GitHub custom properties and repository-level action SHA-pinning enforcement are unavailable for this user-owned repository. Workflow source pins third-party actions instead.
- 2026-09-01: Added deterministic topology, dry-run, registry-invariant, explicit-config, and documentation-parity contracts; cited Limited Edition Jonathan's nested symlink workaround without expanding Agentlink into content generation.
- 2026-09-01: Clarified that Agentlink manages identical filesystem aliases while explicit real wrappers may layer tool-specific guidance; added integration metadata, config-aware scanning, and opt-in nested alias discovery without adding content generation.
- 2026-08-20: Added the first repo-scoped intent contract during the repository lifecycle pilot.