← Back
landoncrabtree

landoncrabtree/etymon

Replace all of your harness-specific files: CLAUDE.md, AGENTS.md, opencode.json, codex.json, .cursor/rules/, .mcp.json, etc. with Etymon.

View on GitHub ↗
Stars
3
Forks
0
Watchers
3
Open issues
0
Contributors
1
Language
TypeScript
License
MIT License
Default branch
main
Created Oct 1, 2026Updated Oct 1, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

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 case: LobeHub

A real local conversion of LobeHub with Etymon 0.1.1. Fifty skills and four rules move into Etymon source under .agents. The .codex and .gemini skill symlinks and root instruction files leave Git. Workflow prompts in .claude, documentation in .cursor, and .github CI remain tracked.

LobeHub: 50 skills, 4 rules, converted and synced with the published CLI. Reproduce the demo.

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 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
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

Contributing

Humans: docs/CONTRIBUTING.md.

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