agentsync

편집 once, 적용 everywhere

MCP 서버나 플러그인을 한 번 정의하면 agentsync가 31개 이상의 지원 에이전트에 맞게 설정을 변환하여 적용합니다. 에이전트가 해당 개념을 완전히 지원하는 경우 완전하게, 부분적으로 지원하는 경우 손실이 있지만 보고되며, 지원하지 않는 경우는 건너뛰되 silenziously 하지 않습니다.

양방향 chezmoi-style 동기화

에이전트가 자체 설정을 수정하면 agentsync가 드리프트를 감지하고, 사용자가 수정을 표준 소스로 받아들일지 또는 표준 소스를 재적용할지 선택할 수 있도록 병합 옵션을 제공합니다.これにより、설정이 사용자의 의도 없이 덮어쓰여지는 것을 방지합니다.

비밀 관리

${secret:github.token}과 같은 비밀 참조를 정의하면, agentsync는 적용 시 age-encrypted 볼트에서 실제 값을 해결하여 사용하지만, 평문 비밀을 표준 소스에 다시 기록하지 않아 보안을 유지합니다.

되돌릴 수 있는 적용

agentsync apply는 각 에이전트 설정 디렉터리(예: ~/.claude)를 로컬-only git 히스토리로 유지하므로, agentsync revert 명령을 통해 이전 체크포인트로 롤백할 수 있습니다. 이때 추적되지 않은 파일은 건드리지 않습니다.

다운로드·설치 방법

Windows에서는 Scoop 또는 Chocolatey를 통해 agentsync를 설치할 수 있습니다. Scoop을 사용할 경우, 먼저 버킷을 추가한 후 설치를 진행합니다.

scoop bucket add spxrogers https://github.com/spxrogers/scoop-bucket
scoop install agentsync

Chocolatey를 사용하는 경우 다음과 같이 설치합니다.

choco install agentsync

또한, GitHub 릴리스 페이지에서 사전 빌드된 바이너리를 다운로드하여 PATH에 추가하는 방법도 지원됩니다. Windows용 아카이브를 다운로드하고 압축을 풀면 agentsync 실행 파일을 사용할 수 있습니다.

기본 사용법/명령어

설치 후, agentsync를 초기화하고 에이전트를 추가하는 기본 워크플로우는 다음과 같습니다. 먼저 저장소를 초기화하고, 사용할 에이전트를 등록한 후 MCP 서버를 추가합니다.

agentsync init
agentsync agent add claude
agentsync agent add opencode
agentsync mcp add github --command npx --args "-y,@modelcontextprotocol/server-github"
agentsync mcp add linear --type http --url https://mcp.linear.app/sse --header "Authorization: Bearer ${secret:LINEAR_TOKEN}"

변경 사항을 적용하기 전에 dry-run을 통해 미리 볼 수 있습니다.

agentsync apply --dry-run
agentsync apply

동기화 상태를 확인하거나 드리프트를 감지하려면 다음 명령을 사용할 수 있습니다.

agentsync status --exit-code
agentsync diff --agents claude --exit-code

적용 후 문제가 발생하면 특정 에이전트의 설정을 이전 체크포인트로 되돌릴 수 있습니다.

agentsync revert claude

이런 경우에 유용합니다

여러 AI 코딩 에이전트를 동시에 사용하는 개발자에게 유용합니다. 예를 들어 Claude Code와 Cursor를 번갈아 사용할 때, 각 에이전트의 설정을 수동으로 동기화하는 대신 agentsync를 통해 하나의 소스에서 관리하면 설정 drift를 방지하고 일관된 개발 환경을 유지할 수 있습니다. 특히 MCP 서버나 플러그인을 자주 추가하거나 업데이트하는 경우, 한 번의 정의로 모든 에이전트에 반영되어 작업 효율성이 향상됩니다.

지원 환경·시스템 요구사항

agentsync는 Windows, macOS, Linux에서 실행됩니다. Windows에서는 사전 빌드된 바이너리를 사용하거나 Scoop, Chocolatey를 통해 설치할 수 있으며, 바이너리는 PATH에 추가되어야 정상적으로 실행됩니다. 또한, 소스에서 빌드하려면 Go 환경이 필요하며, go install github.com/spxrogers/agentsync/cmd/agentsync@latest 명령을 사용할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.14.0이며, GitHub 저장소의 릴리스 페이지에서 최신 버전과 업데이트 내역을 확인할 수 있습니다. 버전 업데이트 시 에이전트 지원 범위 확장, 버그 수정, 보안 개선 등이 포함될 수 있습니다.

제한 사항·확인 사항

일부 에이전트에서는 기능이 손실되거나 지연되어 적용될 수 있습니다. 예를 들어 OpenCode의 후크는 JS/TS 플러그인이므로 agentsync가 Claude 후크를 자동으로 변환하지 않으며, 사용자가 직접 JS/TS 플러그인을 작성해야 합니다. 또한, TOML 또는 JSONC 파일의 주석은 agentsync가 작성 back 또는 적용 시 보존되지 않으며, Zed와 같은 편집기의 설정 파일에서는 첫 번째 적용 시 주석이 제거되고 키가 재정렬될 수 있습니다. 에이전트가 소유한 파일에 수동으로 수정을 가한 경우, 다음 적용 시 덮어쓰여질 수 있으므로 agentsync reconcile 명령을 통해 먼저 write-back 옵션을 선택하는 것이 좋습니다.

FAQ

• agentsync는 무료로 사용할 수 있나요?
  네, agentsync는 MIT 라이선스 하에 오픈소스로 제공되며, 비용 없이 사용하고 수정할 수 있습니다.
• Windows에서 정상적으로 작동하나요?
  네, agentsync는 Windows용 사전 빌드된 바이너리를 제공하며, Scoop 또는 Chocolatey를 통해 설치할 수 있습니다. 바이너리를 다운로드하여 PATH에 추가하면 바로 사용할 수 있습니다.
• 비밀은 어떻게 관리되나요?
  ${secret:키 이름} 형태의 참조를 사용하면, agentsync는 적용 시 age-encrypted 볼트에서 실제 값을 해결하여 사용하지만, 평문 비밀을 표준 소스에 기록하지 않아 보안을 유지합니다.