Skip to content

PROJECT_CONTEXT.md

Latest commit

 

History

History
67 lines (56 loc) · 3.28 KB

PROJECT_CONTEXT.md

File metadata and controls

67 lines (56 loc) · 3.28 KB
Raw

Project Context: Agentlink

What it is

Agentlink is a small, dependency-free Go CLI that keeps AI coding-tool instruction files in sync via plain filesystem symlinks — one real source file (e.g. AGENTS.md or CLAUDE.md), symlinked out to every tool-specific path a machine or repo needs (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, .cursorrules, etc.). No codegen, no templating, no transforms — "zero magic."

It began as a fork of martinmose/agentlink by Martin Mose Facondini (MIT licensed) and is now maintained as a standalone Snap Synapse project. Upstream attribution is preserved in NOTICE.

Audience

  • Individuals and teams running multiple AI coding assistants (Claude Code, Codex CLI, Gemini CLI, Cursor, Aider, etc.) who are tired of maintaining near-duplicate instruction files by hand
  • Go developers comfortable installing via Homebrew, a pre-built binary, or go install github.com/snapsynapse/agentlink/cmd/agentlink@latest
  • Contributors extending the tool registry (internal/registry/tools.go) when new AI coding tools appear

Style / tone (from README and docs)

  • Direct, terse, engineer-to-engineer. Short declarative sentences, minimal hedging.
  • Confident about scope boundaries ("Scope: instruction files only. No MCP .mcp.json or chain configs. Simple on purpose.")
  • Uses concrete code blocks over abstract explanation; every claim is backed by a runnable example.
  • Not marketing copy — no hype language. Explains why a design choice was made (e.g. why no codegen, why zero runtime dependencies).
  • FAQ section answers scope-boundary questions directly and briefly.

Key URLs

Current status

  • v0.6.0: review mitigations, refreshed registry with vendor evidence, generated homepage support listing, and explicit --global selection. Assistant guide 1.2.4 targets the v0.6.0 immutable release anchor.
  • Actively maintained; v0.5.0 added layered-instruction workflows, deterministic scan contracts, and current Go compatibility coverage
  • CI (GitHub Actions, .github/workflows/ci.yml) verifies the Go 1.23.12 minimum contract, current Go 1.26.8 and 1.27.1 releases, and Go 1.27.1 on macOS. It enforces build, unit tests, integration tests, the race detector, module consistency, gofmt, go vet, Staticcheck 2026.2.1, spelling, workflow semantics, reachable-vulnerability checks, and release-script syntax on every push/PR
  • Distribution: Homebrew tap, pre-built binaries (darwin/linux, amd64/arm64), direct go install; AUR package listed as planned/not yet shipped
  • Tool registry covers ~23 AI coding tools; new tools are added via PR to internal/registry/tools.go
  • Publishes a "GuideCheck" Human-Verifiable Assistant Guide targeting Level 4 conformance for bounded, approval-gated local setup/verification work by AI assistants