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/

.mdc rules + skills/ + agents/

Codex

~/.codex/

config.toml + skills/

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 per editor — .mdc for Cursor, AGENTS.md for OpenCode/Codex.

Skills & agents

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

Workspaces

Register workspace directories. Repos inside get rules, skills, and agents propagated as symlinks for OpenCode and Codex. Cursor workspace propagation is intentionally disabled to avoid duplicate MCP initialization in multi-root workspaces.

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

Feature	OpenCode	Cursor	Codex
MCP sync	✓	✓	✓
Rules sync	✓	✓	✓
Skills sync	✓	✓	✓
Agents sync	✓	✓	✓
Workspace root AGENTS.md link	✓	✓	✓
Native repo config include for workspace AGENTS.md	✓	—	—
Repo/subdir gets shared workspace AGENTS.md today	✓	—	—
Root-level AGENTS.md discovery only	—	✓	✓
Workspace propagation	✓	—	✓
Import from	✓	✓	✓
Interactive TUI	✓	✓	✓

OpenCode includes the shared workspace AGENTS.md through instructions. Cursor is documented around root-level AGENTS.md, and Codex documents AGENTS.md discovery without a native extra-file include, so repo/subdir sessions do not reliably inherit the shared workspace file today.

Get started

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

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

Preview and apply

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

code-agnostic plan
code-agnostic apply

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
rules/skills/agents add commands
Planner integration for cross-compiled skills and agents
Shell auto-complete
Full TUI mode

One config,every AI editor.