Cursor vs OpenCodeComparisonUpdated 2026-03-16
SUMMARY
Cursor (IDE) uses mdc configuration while OpenCode (CLI) uses markdown. They differ on 4 of 11 compared features. Both tools provide AI-assisted development but take different approaches to project configuration.
FEATURE COMPARISON
| Feature | Cursor | OpenCode |
|---|---|---|
| Config format | mdc | markdown |
| Hierarchy support | ✓ | ✓ |
| Global config | ✓ | ✓ |
| Project config | ✓ | ✓ |
| Subdirectory scoping | ✓ | ✓ |
| File inclusion / imports | ✗ | ✗ |
| Ignore file | .cursorignore | ✗ |
| IDE integration | ✓ | CLI |
| Schema / structure | Hybrid (MDC frontmatter + Markdown) | Free-form (Markdown) |
| Git committed | ✓ | ✓ |
| Encoding | UTF-8 | UTF-8 |
SIDE-BY-SIDE CODE SAMPLES
Cursor
.cursor/rules/*.mdc
mdc
---
description: React component conventions and patterns
globs: "*.tsx"
alwaysApply: false
---
# React Component Rules
- Use functional components with explicit return types
- Define props interface directly above the component
- Export components as named exports, never default
- Use Tailwind CSS utility classes exclusively
OpenCode
AGENTS.md
markdown
# Project Instructions
## Overview
This is a TypeScript monorepo using pnpm workspaces.
## Code Style
- Use strict TypeScript with no implicit any
- Prefer functional components with hooks
- All exports should be named (no default exports)
## Architecture
- /packages/core — shared business logic
- /packages/ui — React component library
- /apps/web — Next.js frontend
## Build & Test
Run tests with: pnpm test
Build all packages: pnpm build
All PRs must have >80% coverage on changed files.
## Conventions
- Use conventional commits (feat:, fix:, chore:)
- Prefer composition over inheritance
- See @docs/api-guidelines.md for API design patterns
KEY DIFFERENCES
Cursor: mdc. OpenCode: markdown.
Cursor: .cursorignore. OpenCode: Not supported.
Cursor: Supported. OpenCode: CLI.
Cursor: Hybrid (MDC frontmatter + Markdown). OpenCode: Free-form (Markdown).
WHICH SHOULD I USE?
Choose based on your IDE/CLI preference. If you use Cursor, configure .cursorrules. If you use OpenCode, configure AGENTS.md. Many projects include config files for multiple tools so each team member can use their preferred editor.
PORTABILITY TIP
sync-instructions.sh
bash
# Maintain a single source of truth:
cp AI-INSTRUCTIONS.md CLAUDE.md
cp AI-INSTRUCTIONS.md .cursorrules
cp AI-INSTRUCTIONS.md AGENTS.md
SEE ALSO
File references:
agentconfig.ing2026-03-16COMPARE(1)