TL;DR

  • Etymon은 CLAUDE.md, AGENTS.md, opencode.json, .codex/config.toml, .cursor/rules/, .mcp.json 등 도구별 설정을 etymon.toml과 etymon.lock으로 대체해 저장소를 다양한 AI 하네스에서 사용할 수 있게 하는 도구임.
  • etymon init과 etymon convert로 새 저장소와 기존 저장소를 초기화하고 설정을 가져올 수 있음.
  • 스킬(Skills), 에이전트(Agents), 규칙(Rules), MCP 서버를 로컬 파일이나 외부 소스에서 추가하고 관리할 수 있음.
  • etymon sync는 잠금된 버전을 적용하며, Claude, Codex, OpenCode 등 하네스를 지정하거나 오프라인·미리 보기 방식으로 실행할 수 있음.
  • Node.js 22 이상과 저장소 소스용 Git이 필요하며, Claude Code, Codex, Copilot, VS Code 등 다양한 도구 인터페이스를 지원함.

Etymon 소개

  • CLAUDE.md, AGENTS.md, opencode.json, .codex/config.toml, .cursor/rules/, .mcp.json 등 도구별 설정을 하나의 공유 매니페스트와 잠금 파일인 etymon.toml, etymon.lock으로 대체하는 도구임.
  • Etymon을 사용해 저장소를 이식 가능하고 AI 하네스에 종속되지 않는 형태로 관리할 수 있음.
  • 웹사이트와 CLI 참조 문서를 제공함.

설치

  • 전역 설치 명령은 npm install -g etymon이며, 설치 후 etymon을 실행함.
  • 전역 설치 없이 실행하려면 npx etymon을 사용함.
  • Node.js 22 이상이 필요하며, 저장소 소스를 사용할 경우 Git이 필요함.

새 저장소

  • etymon init으로 저장소를 초기화함.
  • etymon skills add vercel-labs/skills --skill find-skills로 스킬을 추가하고, etymon mcp add io.github.upstash/context7 --remote 0으로 원격 MCP 서버를 추가함.
  • etymon skills create, etymon agents create, etymon rules create로 자체 스킬, 에이전트, 규칙을 만들 수 있음.
  • etymon sync --harness claude,codex,opencode로 Claude, Codex, OpenCode 하네스에 동기화함.
  • 기여자는 etymon sync를 실행함.

기존 저장소

  • etymon init으로 저장소를 초기화하고 etymon convert로 기존 도구 설정을 변환함.
  • etymon sync --harness codex,opencode로 Codex와 OpenCode 하네스에 동기화함.
  • 기여자는 etymon sync를 실행함.

자주 쓰는 명령

  • 검색과 정보 확인: etymon skills find react, etymon mcp find context7, etymon mcp info io.github.upstash/context7.
  • 스킬·에이전트·규칙·MCP 추가: 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로 단일 도구의 설정을 가져옴.
  • etymon list로 항목을 나열하고 etymon update로 외부 리소스의 최신 버전을 선택함.
  • etymon sync로 잠금된 버전을 적용하며, etymon sync --offline은 캐시된 리소스를 사용하고 etymon sync --dry-run은 변경 사항을 검토함.
  • etymon sync --allow-lossy는 경고와 함께 변환 과정의 정보 손실을 허용하며, 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을 제거함.
  • CLI 참조 문서는 헤드리스 생성, 소스 확인, 전역 옵션을 포함함.

인터페이스와 도구

  • 스킬 소스: 로컬 폴더, skills.sh, Git.
  • MCP 소스: 로컬 JSON, MCP 레지스트리.
  • 에이전트 소스: 로컬 파일, Git, 파일 URL.
  • 규칙 및 지침 소스: 로컬 파일, Git, 파일 URL.
  • 지원 도구: Claude Code, Codex, Copilot CLI 및 클라우드, VS Code, Gemini, Kiro, Pi, Oh My Pi, OpenCode, Cursor, Antigravity, Roo, Cline, Kilo, Continue, Windsurf, Amp, Zed.
  • 도구별 지원 인터페이스와 규칙 호환성 정보를 제공함.

기여

  • 사람 기여자는 docs/CONTRIBUTING.md를 참고함.
  • 에이전트는 etymon sync를 실행한 다음 생성된 프로젝트 지침과 개발 스킬을 읽음.