etymon

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

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.