원문 캡처 · github.com
원문 캡처 · github.com

저장소마다 따로 두던 AI 도구 설정을 etymon.toml과 etymon.lock 두 파일로 통합할 수 있다. Etymon은 이 설정을 여러 도구에 맞춰 다시 적용한다.

Etymon은 저장소의 AI 도구별 설정을 하나의 공통 매니페스트와 잠금 파일로 관리하는 도구다. 여러 AI 코딩 도구를 함께 쓰거나, 저장소 설정을 도구에 덜 종속되게 관리하려는 팀에 쓸모가 있다.

Etymon은 무엇을 통합하나?

여러 도구에 흩어진 설정을 한 곳에서 관리하는 방식은 공통 서랍 하나에 설정을 모아 두는 것에 빗대면 이해하기 쉽다. Etymon은 CLAUDE.md, AGENTS.md, opencode.json, .codex/config.toml, .cursor/rules/, .mcp.json 등의 설정을 etymon.toml과 etymon.lock으로 관리한다.

이 도구는 스킬, MCP, 에이전트, 규칙과 지침을 다룬다. 스킬은 로컬 폴더·skills.sh·Git에서 가져올 수 있고, MCP는 로컬 JSON 파일이나 MCP Registry를 출처로 삼는다. 에이전트와 규칙·지침은 로컬 파일, Git, 파일 URL에서 가져올 수 있다.

새 저장소와 기존 저장소에서 어떻게 쓰나?

새 저장소에서는 초기화한 뒤 외부 스킬과 MCP를 추가하거나, 직접 스킬·에이전트·규칙을 만들 수 있다. 설정을 Claude, Codex, OpenCode에 적용하는 예시는 다음과 같다.

sh
npm install -g etymon
etymon

# Or run without installing globally
npx etymon

# New repo
etymon init

etymon skills add vercel-labs/skills --skill find-skills
etymon mcp add io.github.upstash/context7 --remote 0

# Create your own skills, agents, and rules
etymon skills create
etymon agents create
etymon rules create

etymon sync --harness claude,codex,opencode

# Contributors
etymon sync

기존 저장소는 etymon convert로 도구별 설정을 가져온 다음, 원하는 도구에 맞춰 동기화할 수 있다.

sh
# Existing repo
etymon init
etymon convert
etymon sync --harness codex,opencode

# Contributors
etymon sync

추가·검색·동기화 명령은 무엇인가?

스킬이나 MCP를 검색하고 정보를 확인할 수 있다. 로컬 자료나 Git 저장소의 스킬·에이전트·규칙을 추가하고, 로컬 JSON 파일에서 MCP를 가져오는 명령도 제공한다.

sh
etymon skills find react
etymon mcp find context7
etymon mcp info io.github.upstash/context7

etymon skills add ./skills/checks
etymon agents add augmnt/agents/api-designer.md
etymon rules add ./guidance.md --dest-dir src/api
etymon mcp add ./mcp.json
etymon mcp create
etymon convert --harness claude # Import one tool

etymon list
etymon update # Choose newer external versions
etymon sync # Apply the locked versions
etymon sync --offline # Use cached resources
etymon sync --dry-run # Review changes
etymon sync --allow-lossy # Allow conversion losses, with warnings
etymon doctor

etymon skills remove checks
etymon agents remove reviewer
etymon rules remove guidance
etymon mcp remove docs

etymon skills create --global
etymon sync --global --harness claude,codex
etymon uninstall

etymon update는 외부 자료의 최신 버전을 선택하고, etymon sync는 잠금 파일에 고정된 버전을 적용한다. 오프라인 동기화, 변경 사항 사전 검토, 변환 과정의 손실을 경고와 함께 허용하는 옵션도 있다. etymon doctor로 점검하고, 전역 설정을 만들거나 동기화한 뒤 도구를 제거할 수도 있다.

쓰기 전에 확인할 조건은?

Node.js 22 이상이 필요하다. Git 저장소에서 자료를 가져오는 경우 Git도 설치해야 한다. 지원 도구에는 Claude Code, Codex, Copilot CLI/cloud, VS Code, Gemini, Kiro, Pi, Oh My Pi, OpenCode, Cursor, Antigravity, Roo, Cline, Kilo, Continue, Windsurf, Amp, Zed가 포함된다. 도구별 지원 인터페이스와 규칙 호환성은 별도 참조 문서에서 확인하도록 안내한다.

전체 명령줄 인터페이스 참조에는 비대화형 생성, 출처 확인, 전역 옵션도 포함된다. 기여자는 etymon sync를 실행한 다음 생성된 프로젝트 지침과 개발 스킬을 읽도록 안내받는다. 원문은 Etymon의 가격이나 도구별 지원 범위의 세부 차이를 밝히지 않는다.