Etymon：用一个共享清单和锁文件替代 CLAUDE.md、AGENTS.md、cursor/rules、mcp.json 等配置

Replace CLAUDE.md, AGENTS.md, opencode.json, .codex/config.toml, .cursor/rules/, .mcp.json, and other tool-specific setup with one shared manifest and lockfile: etymon.toml and etymon.lock.

Make your repositories portable and AI harness-agnostic with Etymon.

Website · CLI reference

Use cases

Real migrations with published Etymon 0.1.1: LobeHub consolidates nine agent setup locations into .agents, Ant Design six, and Formbricks seven. Imported originals were explicitly retired after verification. These views show imported agent resources; other repository files remain unchanged.

LobeHub · Ant Design · Formbricks. Real local migrations with [email protected]. Imported agent resources shown; other repo files kept.

Install

npm install -g etymon
etymon

# Or run without installing globally
npx etymon

Node.js 22+ and Git for repository sources.

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

Existing repo

etymon init
etymon convert
etymon sync --harness codex,opencode

Contributors

etymon sync

Common commands

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 commands add ./.cursor/commands # Modernize commands into skills
etymon commands create                # Create a manual-only skill
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

Full CLI reference, including headless creation, source resolution, and global options.

Interfaces and tools

Interface	Sources
Skills	Local folders, skills.sh, Git, legacy commands
MCP	Local JSON, MCP Registry
Agents	Local files, Git, file URLs
Rules & Instructions	Local files, Git, file URLs

Claude Code, Codex, Copilot CLI/cloud, VS Code, Gemini, Kiro, Pi, Oh My Pi, OpenCode, Cursor, Antigravity, Roo, Cline, Kilo, Continue, Windsurf, Amp, and Zed.

Supported interfaces by tool · Rule compatibility · Command migration

Contributing

Humans: docs/CONTRIBUTING.md.

Agents: run etymon sync, then read the generated project instructions and development skills.