sleuth-io/sx

sx란 무엇인가?

sx(발음은 ess-ex)는 팀 전체에서 AI "스킬" 및 관련 자산 – 사용자 정의 프롬프트, 규칙, 에이전트, 명령, 훅, 그리고 작은 Model-Context-Protocol (MCP) 서버까지 – 을 공유하기 위한 도구입니다. 일반적인 동기화 폴더(Dropbox, Google Drive, OneDrive 등) 또는 Git 리포지토리를 매니페스트(sx.toml)와 잠금 파일과 함께 해당 자산을 저장하는 볼트로 취급합니다. 볼트는 단일 소스 오브 트루스가 되며, sx 앱 또는 sx CLI는 다음을 수행할 수 있습니다:

자산을 볼트에 추가 (sx add ...).
특정 범위(조직, 리포지토리, 경로, 팀, 봇 또는 개별 사용자)에 설치 (sx install ...).
누가 무엇을 사용하고 얼마나 많은 토큰이 소비되는지 추적 (sx stats).
모든 변경 사항을 감사 (sx audit).
경량 WebSocket 릴레이를 통해 웹 기반 AI 어시스턴트(Claude, ChatGPT)에 볼트를 노출 (sx cloud ...).

이 모든 것은 전용 서버 없이 작동합니다. 공유 폴더 자체가 인프라이며, CLI는 스크립트화하거나 CI 파이프라인에서 실행할 수 있습니다.

누가 사용할까요?

역할	도움이 되는 이유
비기술팀 동료	그래픽 앱을 사용하여 스킬을 드래그 앤 드롭하고 팀과 공유합니다 – Git이나 터미널이 필요 없습니다.
엔지니어 / DevOps	스크립트 또는 CI에서 자산 게시 및 설치를 자동화합니다 (`sx add`, `sx install`, `sx vault copy`).
팀 리더 / 매니저	도입 대시보드(`sx stats`)와 불변 감사 추적(`sx audit`)을 통해 어떤 스킬이 실제로 사용되는지 확인할 수 있습니다.
AI 도구 통합자	Claude Code, GitHub Copilot, Cursor, Gemini, Kiro 등에 대한 올바른 구성 파일을 생성하여 동일한 스킬이 어디서나 작동하도록 합니다.
자율 에이전트 플랫폼의 제품 소유자	전체 에이전트(프롬프트 + 스킬 + 규칙 + 훅)를 한 번 패키징하고 지원되는 모든 클라이언트에 변경 없이 배포합니다.

어떻게 작동하나요?

볼트 – 다음을 포함하는 폴더(로컬, 동기화 또는 Git):
- sx.toml – 모든 자산, 버전 및 설치할 범위를 나열하는 매니페스트.
- sx.lock – 매니페스트의 사용자별 해결된 보기(package-lock.json과 유사).
- .sx/ – 감사 로그, 사용 로그 및 생성된 플러그인 설명자.
CLI / 앱 – 둘 다 동일한 구성을 읽고 쓰므로 GUI에서 수행된 작업이 터미널에 즉시 나타나고 그 반대의 경우도 마찬가지입니다.
범위 지정 – sx install <asset> --org 또는 --team <name>을 실행하면 도구는 대상 AI 클라이언트의 구성 디렉토리에 적절한 파일을 작성하여 일반 자산 정의를 클라이언트별 형식으로 변환합니다.
클라우드 릴레이 – sx cloud serve는 웹 기반 어시스턴트(Claude, ChatGPT)의 MCP 요청을 WebSocket을 통해 로컬 볼트로 전달하는 작은 프로세스를 실행하여 볼트 데이터를 비공개로 유지합니다.
Go 라이브러리 – 동일한 로직이 pkg/sxvault로 노출되어 다른 Go 프로그램(예: hetchy 샌드박스 러너)이 볼트를 직접 읽고 쓸 수 있습니다.

볼트에 실제로 무엇을 넣을 수 있나요?

자산 유형	일반적인 내용
스킬	프롬프트 템플릿, 시스템 메시지, 선택적 예제 입력.
규칙	린트 스타일 지침, 파일 형식 제한, 자동 서식 정책.
에이전트	프롬프트와 필요한 스킬/규칙을 묶은 명명된 봇 정의.
명령	클라이언트 UI에서 호출할 수 있는 슬래시 명령 문자열.
훅	수명 주기 이벤트(예: Claude 세션 시작 전)에서 실행되는 스크립트.
MCP 서버	사용자 정의 데이터 소스에 대한 모델 컨텍스트 프로토콜을 노출하는 작은 HTTP/WebSocket 서비스.
플러그인	볼트에서 자동으로 생성된 패키지된 Claude Code 또는 Codex 플러그인 매니페스트.

시작하기 (빠른 시작)

# CLI 설치 (macOS / Linux)
brew tap sleuth-io/tap && brew install sx
# 또는 원라이너 스크립트 사용
curl -fsSL https://raw.githubusercontent.com/sleuth-io/sx/main/install.sh | bash

# 동기화 폴더에 볼트 초기화
sx init --type path --path ~/Dropbox/sx-vault

# 스킬 추가 (앱에서 드래그 앤 드롭 또는 CLI 사용)
sx add ~/.claude/skills/my-skill

# 팀 전체에 설치 (조직 전체 범위)
sx install my-skill --org

# 누가 사용하고 있는지, 토큰 소비량 확인
sx stats --since 7d --json

동일한 단계를 CLI를 자동으로 번들하는 데스크톱 앱에서도 수행할 수 있습니다.

제한 사항 / 미해결 질문

영역	현재 상태
RBAC / 변경 요청 흐름	계획됨(로드맵 항목).
엔터프라이즈급 호스팅	대규모 팀은 호스팅되는 Skills.new 서비스를 사용할 수 있습니다. 자체 호스팅은 폴더 기반 모델로 제한됩니다.
지원되는 AI 클라이언트	광범위함(Claude, Codex, Cursor, GitHub Copilot, Gemini, Kiro 등) 그러나 일부 클라이언트는 자산 유형의 하위 집합만 지원합니다(예: Gemini JetBrains – 규칙만).
크로스 플랫폼 일관성	앱과 CLI는 단일 구성을 공유하지만 번들된 CLI는 자체 업데이트되지 않습니다. 자동 업데이트를 위해서는 별도의 설치가 필요합니다.

TL;DR

sx는 AI 관련 자산을 위한 제로 인프라, 버전 관리 볼트 시스템입니다. 기술적이든 아니든 모든 팀이 스킬, 에이전트, 규칙, 명령, 훅, 작은 MCP 서버를 저장, 버전 관리, 범위 지정, 감사할 수 있으며 지원되는 모든 AI 어시스턴트(Claude, Copilot, Cursor, Gemini 등)에 자동으로 설치합니다. 이 도구는 크로스 플랫폼 데스크톱 앱과 Go 기반 CLI로 제공되며, 더 깊은 통합을 위한 Go 라이브러리도 포함합니다.