basemd

Unified AI agent rules manager - create symlinks for AGENTS.md, CLAUDE.md, GEMINI.md pointing to a single base.md.

Why?

Different AI assistants look for different config files:

• GitHub Copilot / OpenAI Codex → AGENTS.md
• Claude → CLAUDE.md
• Gemini → GEMINI.md

Instead of maintaining 3 separate files, use basemd to create symlinks pointing to a single source of truth.

Usage

# Initialize with defaults
npx basemd init

# Check current status
npx basemd status

# Custom base file
npx basemd init --base ./my-rules.md

# Only create specific symlinks
npx basemd init --targets CLAUDE.md,AGENTS.md

# Force overwrite existing files
npx basemd init --force

What it does

1. Creates .agents/rules/base.md (with default template if not exists)
2. Creates symlinks:

   AGENTS.md  →  .agents/rules/base.md
   CLAUDE.md  →  .agents/rules/base.md
   GEMINI.md  →  .agents/rules/base.md

Install globally (optional)

npm install -g basemd

License

MIT