AI Sparkup

최신 AI 쉽게 깊게 따라잡기⚡

sx – 팀 AI 스킬과 에이전트 자산을 여러 도구에 배포하는 vault 관리자

sx는 AI 스킬, MCP 서버, 에이전트, 규칙, 명령어, 훅 같은 에이전트 자산을 한 곳에서 관리하고 여러 AI 도구의 네이티브 형식으로 설치해주는 오픈소스 배포 도구다.

왜 필요한가

AI 에이전트 자산은 보통 개인 홈 디렉터리나 특정 프로젝트 저장소 안에 흩어진다. 좋은 agent-skills를 만들어도 Claude Code, Codex, Cursor, Gemini CLI 같은 도구마다 설치 위치와 형식이 다르고, 팀원이 복사해 쓰기 시작하면 버전이 금방 갈라진다.

sx는 이 문제를 vault라는 공유 원천(source of truth)으로 푼다. 사용자는 스킬이나 규칙을 vault에 추가하고, sx는 현재 사용자·저장소·경로·팀·봇 범위에 맞는 자산만 각 클라이언트 위치에 설치한다.

핵심 기능

영역설명
자산 관리스킬, 규칙, 에이전트, 명령어, 훅, MCP 서버, 플러그인을 vault에 등록하고 버전 관리한다.
배포 범위조직 전체, 특정 저장소, 특정 경로, 팀, 사용자, 봇 단위로 설치 범위를 나눈다.
클라이언트 변환하나의 자산을 Claude Code, Codex, Cursor, Gemini CLI 등 각 도구의 네이티브 형식으로 쓴다.
관측과 감사sx stats로 사용 현황을 보고, sx audit로 팀·설치 변경 기록을 추적한다.
운영 모델로컬 폴더, Dropbox·Google Drive 같은 동기화 폴더, Git vault, Skills.new를 선택할 수 있다.

설치와 기본 사용

macOS나 Linux에서는 Homebrew로 설치할 수 있다.

brew tap sleuth-io/tap
brew install sx

공유 폴더를 팀 vault로 쓰는 최소 흐름은 다음과 같다.

sx init --type path --path ~/Dropbox/sx-vault
sx add ~/.claude/skills/my-skill
sx install

이 방식은 GitHub 계정이나 별도 서버 없이 팀이 이미 쓰는 동기화 폴더를 배포 백엔드로 삼는다는 점이 특징이다. CLI에 익숙하지 않은 팀은 데스크톱 앱에서 같은 vault를 지정하고 스킬을 끌어다 놓는 방식으로 쓸 수 있다.

vault와 lock 구조

sx는 npm이나 cargo처럼 manifest와 lock 구조를 따른다.

  • sx.toml: vault의 원천 선언 파일이다. 관리 자산, 설치 범위, 팀 정의를 담는다.
  • lock 파일: sx install이 현재 사용자와 범위를 해석해 만든 결과물이다. 사용자의 캐시 디렉터리에 저장되고, 변경 시 이전 lock을 보존한다.
  • .sx/audit/, .sx/usage/: 설치·팀 변경 기록과 사용 이벤트를 JSONL로 남긴다.

이 구조 덕분에 팀은 “모든 자산을 항상 설치”하는 대신 필요한 범위에만 설치할 수 있다. 컨텍스트를 줄이고, 특정 저장소나 봇에만 필요한 지침이 다른 작업에 섞이는 문제도 줄어든다.

플러그인 마켓플레이스 생성

Git 또는 path vault는 Claude Code와 Codex용 플러그인 마켓플레이스로도 노출될 수 있다. sx는 publish 과정에서 .claude-plugin/marketplace.json.codex-plugin/plugin.json을 생성·유지한다. sx를 직접 쓰지 않는 팀원도 AI 도구의 플러그인 설치 흐름으로 필요한 컬렉션만 가져갈 수 있다.

언제 쓰면 좋은가

  • 여러 프로젝트에서 같은 스킬과 에이전트 규칙을 재사용하는 팀
  • 개발자와 비개발자가 함께 AI 스킬을 공유해야 하는 조직
  • Claude Code, Codex, Cursor, Gemini CLI 등 여러 클라이언트를 병행하는 사용자
  • CI 봇, 리뷰 봇, 문서 봇처럼 역할별 에이전트 자산을 분리해 관리하려는 팀

개인 사용자는 단순한 로컬 vault만으로도 가치가 있다. 하지만 sx가 특히 빛나는 지점은 팀 단위 배포, 범위 지정, 감사 기록이 필요한 순간이다.

라이선스

sx는 Apache-2.0 라이선스로 공개되어 있다. GitHub 저장소 기준 주 구현 언어는 Go이며, 데스크톱 앱과 CLI를 함께 제공한다.

관련 문서

참고 자료



AI Sparkup 구독하기

최신 게시물 요약과 더 심층적인 정보를 이메일로 받아 보세요! (무료)