Beta — work in progress, CLI surface may change

One config,
every AI editor.

Keep MCP servers, rules, skills, and agents in a single hub—sync them into editor-specific layouts.

uv tool install code-agnostic

Or run without installing: uvx code-agnostic

How it works

Source of truth

~/.config/code-agnostic/
├── config/
│   └── mcp.base.json
├── rules/
│   └── python-style.md
├── skills/
│   └── code-reviewer/SKILL.md
└── agents/
    └── architect.md

Compiled & synced

OpenCode
~/.config/opencode/
opencode.json + skills/ + agents/
Cursor
~/.cursor/
mcp.json + skills/ + agents/
Codex
~/.codex/
config.toml + skills/ + agents/
Claude Code
~/.claude.json + ~/.claude/
mcpServers + skills/ + agents/
GitHub Copilot
~/.copilot/ + .github/
mcp + skills/ + agents/
Each resource is cross-compiled to the target editor's native format.

Features

Sync engine

Plan-then-apply workflow. Preview every change before it touches disk.

code-agnostic plan
code-agnostic apply

MCP management

Add, remove, and list MCP servers without editing JSON by hand.

code-agnostic mcp add github \
  --command npx \
  --env GITHUB_TOKEN

Rules with metadata

YAML frontmatter in markdown. Cross-compiled to AGENTS.md for every editor, mirrored to CLAUDE.local.md memory for Claude Code.

Skills & agents

Canonical YAML frontmatter format. Each editor gets a compiled version in its native layout.

Workspaces

Register workspace directories. Repos inside get MCP, rules, skills, and agents propagated for all five editors. Cursor stays repo-local and does not copy the shared workspace AGENTS.md into child repos.

code-agnostic workspaces add \
  --name myproject \
  --path ~/code/myproject

Git exclude

Prevent synced paths from polluting git status. Managed per-workspace with customizable patterns.

Import

Migrate existing config from any supported editor into the hub. Conflict resolution built in.

code-agnostic import apply -a codex

Interactive TUI

Textual-based selector for cherry-picking individual items during import.

code-agnostic import plan -a codex -i

Docker isolation

Run in a container and only mount the paths you want to expose from your host filesystem.

docker run --rm -it \
  -v "$(pwd):/workspace" \
  -w /workspace \
  ghcr.io/dhvcc/code-agnostic:latest plan

Editor support

FeatureOpenCodeCursorCodexClaude CodeCopilot
MCP sync
Rules sync
Skills sync
Agents sync
Import existing config
Interactive TUI import
Workspace repo propagation
Shared workspace AGENTS.md into child repos

All five editors sync MCP, rules, skills, and agents, and receive repo-local workspace propagation. Rules compile to AGENTS.md (mirrored to CLAUDE.local.md for Claude Code). OpenCode includes the shared workspace AGENTS.md via instructions, Codex via a generated AGENTS.override.md, Claude via CLAUDE.local.md, and Copilot under .github/. Cursor loads AGENTS.md already present in the opened project, so code-agnostic does not copy the shared workspace file into child repos.

Get started

01

Import existing config

Pull in MCP servers, skills, and agents from an editor you already use.

code-agnostic import plan -a codex
code-agnostic import apply -a codex
02

Enable target editors

Choose which editors to sync to. Apps start disabled by default.

code-agnostic apps enable -a cursor
code-agnostic apps enable -a opencode
03

Preview and apply

Dry-run first, then apply. Every change is shown before it touches disk.

code-agnostic plan
code-agnostic apply
04

Run in Docker (optional)

Use the published image to isolate filesystem access to mounted paths only.

docker run --rm -it \
  -v "$(pwd):/workspace" \
  -w /workspace \
  ghcr.io/dhvcc/code-agnostic:latest plan

Roadmap

  • Plan/apply/status sync engine
  • MCP server sync across editors
  • Skills and agents sync
  • Workspace propagation into git repos
  • Import from existing editor configs
  • Consistent CLI with named flags and aliases
  • MCP add/remove/list commands
  • Rules system with YAML frontmatter and per-editor compilation
  • Cross-compilation for skills and agents
  • Per-workspace git-exclude customization
  • Interactive TUI for import selection
  • Claude Code support
  • GitHub Copilot support
  • Planner integration for cross-compiled skills and agents
  • Ownership-aware cleanup (prune only what we wrote)
  • rules/skills/agents add commands
  • Shell auto-complete
  • Full TUI mode