<div align="center">
agentsync
사용하는 모든 AI 코딩 에이전트에 대한 단일 진실 공급원입니다.
~/.agentsync/에 MCP 서버, 메모리, 스킬, 마켓플레이스 플러그인을 한 번만 정의하세요. agentsync apply를 실행합니다. 그러면 이 설정들이 — 올바르게 번역되어 — 32개의 에이전트에 적용됩니다: 10개의 심층 어댑터(Claude Code, OpenCode, Codex CLI, Cursor, Gemini CLI, Continue, Windsurf, Roo Code, Cline, Grok Build)와 나머지 22개로 구성된 광범위한 티어(amp, goose, qwen, warp, zed, kiro, junie, factory, copilot, crush, …)가 포함됩니다.
Quickstart · Install · Docs site → agentsync.cc · User guide · Known limits
</div>
상태: beta (v0.1.0). 32개의 에이전트 — 10개의 심층 어댑터(Claude, OpenCode, Codex, Cursor, Gemini, Continue, Windsurf, Roo, Cline, Grok Build) + 22개 에이전트로 구성된 광범위한 티어 — 를 엔드투엔드로 제공합니다.
이 도구는 just test-release에서 기능적으로 테스트되었으며, 표준 레이아웃(canonical layout), CLI 인터페이스, 상태 스키마는 1.0.0을 향해 안정화되고 있으며 여전히 변경될 수 있습니다. 몇 가지 문서화된 트레이드오프가 남아있습니다 (자세히 보기 Known limits).
작동 방식
여러 개의 AI 코딩 에이전트를 사용한다면, 동일한 설정을 각 에이전트의 네이티브 형식으로 계속 다시 입력해야 하고, 모든 곳에 플러그인을 설치하는 것을 잊어버리며, 설정들이 조용히 분산되어 달라지게 됩니다. agentsync는 이러한 확산(fan-out) 문제를 해결합니다:
- 한 번 편집하고 모든 곳에 적용합니다(Edit once, apply everywhere). MCP 서버를 추가하거나 플러그인을 한 번 설치하면, 이 설정이 각 에이전트의 네이티브 구성 파일에 투영됩니다. 개념적으로는 존재하는 곳에는 완전히 반영되고, 그렇지 않은 곳에서는 손실성으로 보고되며, 불가능한 곳에서는 건너뜁니다 (절대 조용히 무시하지 않습니다).
- 양방향(Bidirectional), chezmoi 스타일. 에이전트가 자체 구성 파일을 편집할 때, agentsync는 드리프트(drift)를 감지하고 병합을 제안합니다. 편집 내용을 소스에 채택하거나, 소스를 재강제 적용할 수 있습니다. 귀하의 뒤에서 아무것도 덮어쓰이지 않습니다.
- 비밀 정보는 안전하게 유지됩니다(Secrets stay secret).
${secret:github.token}을 참조하면, agentsync는 이를 암호화된 금고(vault)에서 적용 시점에 해결하며, 평문 텍스트를 귀하의 (커밋 가능한) 소스에 다시 쓰는 일은 절대 없습니다.
- 잘못된 적용도 되돌릴 수 있습니다(A bad apply is revertible).
apply는 각 목적지 디렉터리(~/.claude, ...)를 로컬 전용(local-only) Git 히스토리에 유지합니다 (옵트아웃, 절대 푸시되지 않음). 따라서 agentsync revert는 이전 체크포인트로 롤백하며, 해당 디렉터리에 넣은 추적되지 않거나 gitignore된 파일들은 건드리지 않습니다.
처음이신가요? **사용자 가이드**를 통해 0에서 100까지 안내해 드립니다.
빠른 시작 (Quickstart)
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}\
| Doc | What it covers |
|---|
| User guide | 설치 → 첫 동기화(first sync) → 일일 루프(daily loop) → 비밀 정보(secrets) → 플러그인(plugins) → 프로젝트 설정(project config). |
| ... | |
한눈에 보는 지원 에이전트
10개의 딥 어댑터(deep adapters) (풍부하고, 에이전트별이며, 종종 양방향적):
| Agent | Status | Component coverage |
|---|
| Claude Code | ✓ adapter | MCP, memory, skills, subagents, commands, hooks (◐, command hooks; other handler types reported). LSP는 Claude 플러그인에 의해 제공되지 않는 한 건너뜀. |
| ... | | |
또한 하나의 데이터 기반 범용 어댑터를 통해 22개의 추가적인 **브레드스 티어(breadth tier)**를 지원합니다 — 모든 것을 위한 메모리(memory), 에이전트가 JSON 서버맵을 읽는 MCP (22개 중 15개), 에이전트가 SKILL.md 디렉토리를 네이티브로 스캔하는 에이전트 스킬(Agent Skills) (22개 중 18개) 등이 있습니다. 그리고 Factory 전용 명령어 후크로는 amp, goose, qwen, warp, jules, junie, openhands, amazonq, zed, kilocode, kiro, trae, jetbrains, firebase, antigravity, augmentcode, copilot, copilot-cli, crush, factory, pi, mistral가 있습니다. 이들은 모두 검증된 사양(경로는 상위 문서 및 이전 기술과 교차 참조됨)이며, 딥 어댑터와 동일한 드리프트/비밀 정보/캡처 파이프라인을 통해 흐릅니다. capability matrix → Breadth tier를 참조하세요. | | |
구성 요소별 전체 ✓/◐/✗ 분석: capability matrix.
설치(Install)
macOS — Homebrew
brew tap spxrogers/tap
brew install agentsync
Linux — deb / rpm
아키텍처에 맞는 패키지를 선택하세요. amd64와 arm64 모두 매 릴리스마다 게시됩니다 (아래의 일치하는 URL을 사용하세요).
Debian/Ubuntu:
# amd64
curl -fsSL https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_amd64.deb -o agentsync.deb
# arm64
curl -fsSL https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_arm64.deb -o agentsync.deb
sudo dpkg -i agentsync.deb
RPM:
amd64
sudo rpm -i https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_amd64.rpm
# arm64
sudo rpm -i https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_arm64.rpm
Windows — Scoop 또는 Chocolatey
Scoop:
scoop bucket add spxrogers https://github.com/spxrogers/scoop-bucket
scoop install agentsync
Chocolatey:
각 새로운 Chocolatey 버전은 공개적으로 설치 가능하기 전에 커뮤니티 리포지토리의 자동화된 검사를 거치기 때문에, 최신 릴리스가 다른 채널보다 몇 시간 지연될 수 있습니다.
모든 플랫폼 — npm / Bun
전역으로(globally) 설치한 다음, 설치되는 agentsync 명령어를 실행합니다. npm 패키지는 @spxrogers/agentsync입니다 (npm의 일반화된 agentsync은 관련 없는 프로젝트에 속하기 때문에 스코프 지정이 필요함):
npm install -g @spxrogers/agentsync # 또는: bun add -g @spxrogers/agentsync
agentsync --version
설치 없이 사용해 보려면: npx @spxrogers/agentsync --version (또는 bunx)를 사용합니다.
이 패키지는 작은 Node launcher와 플랫폼별 사전 빌드 바이너리(linux / darwin / win32 × x64 / arm64)로 구성되어 있으며, 이는 선택적 의존성으로 가져오고 설치 스크립트는 없습니다. 바이너리는 GitHub Release에 있는 것이며, 패킹 전에 checksums.txt를 통해 검증됩니다. --omit=optional을 사용하여 설치하면 바이너리가 제외되며, launcher가 이를 알려줍니다.
모든 플랫폼 — 사전 빌드 바이너리(prebuilt binary)
최신 릴리스에서 사용 중인 OS/아키텍처에 맞는 아카이브를 다운로드하고 (linux / darwin / windows × amd64 / arm64), 압축을 해제한 후, agentsync 바이너리를 시스템의 PATH에 위치시키세요.
macOS에서는 사전 빌드된 바이너리가 서명(signed)되거나 노타라이즈(notarized)되지 않았기 때문에 Gatekeeper가 첫 실행 시 *
(Homebrew 사용자는 이것이 필요하지 않습니다. cask가 설치 시 쿼랜틴 속성을 제거해 주기 때문입니다.)
소스에서 설치하기
go install github.com/spxrogers/agentsync/cmd/agentsync@latest
또는 클론하여 go build ./cmd/agentsync를 실행합니다.
곧 출시 예정
AUR (Arch) 패키징은 .goreleaser.yaml에 구현되어 있지만 아직 게시되지 않았습니다 — issue #13에서 추적할 수 있습니다. 그때까지는 미리 빌드된 바이너리 또는 위에 설명된 go install을 사용하세요.
기기 간 동기화 (Cross-machine sync)
agentsync는 단일 머신 전용입니다. 여러 기기에 걸쳐 ~/.agentsync/를 동기화하려면 chezmoi(또는 모든 dotfile 관리자)를 사용하세요:
비밀 정보 (Secrets) — age 키 백업
age 프라이빗 키를 분실하면 모든 암호화된 비밀 정보에 대한 접근 권한을 잃게 됩니다. 권장 사항: 해당 키를 1Password Secure Note 또는 기기 설정 레포지토리(machine-setup repo)에 저장하세요. agentsync는 이 키를 대신 백업해주지 않습니다.
agentsync secret set은 세 가지 방식으로 값을 받습니다:
agentsync secret set github.token --stdin # stdin에서 값 받기 (스크립트 / 1Password CLI에 가장 적합)
agentsync secret set github.token # echo off로 프롬프트 표시
agentsync secret set github.token=ghp_… # 하위 호환성; 경고 — argv는 ps(1) 및 셸 히스토리에 노출됨
agentsync diff는 출력하기 전에 해결된 모든 ${secret:…} 값을 마스킹(redact)하므로, 파이프를 통해 전달되는 diff가 로그에 자격 증명을 유출하는 것을 방지합니다.
알려진 제한 사항 (Known limits)