AI Tool Support

ContextForge installs adapted instructions for each AI tool you select. Each tool gets its own instruction files inside .contextforge/agents/.

The product intentionally keeps real prompt content inside .contextforge/. Root files like AGENTS.md and CLAUDE.md are tiny pointers only.

Codex

OpenAI Codex / general agents

Codex and most general-purpose AI agents read AGENTS.md at the project root. ContextForge writes a tiny pointer there and stores the real adapted instructions inside .contextforge/agents/codex/.

Root pointer file

AGENTS.md

Instruction directory

.contextforge/agents/codex/

·AGENTS.md is created at the repo root
·Contains a pointer to .contextforge/agents/codex/
·Each installed pack gets its own .md file in that folder
·Full skill references are in .contextforge/skills/<pack>/SKILL.md

Claude Code

Anthropic Claude Code CLI

Claude Code reads CLAUDE.md at the repo root. ContextForge writes a tiny pointer there and stores Claude-specific adapted instructions inside .contextforge/agents/claude/.

Root pointer file

CLAUDE.md

Instruction directory

.contextforge/agents/claude/

·CLAUDE.md is created only if you select Claude Code during init
·Claude-specific prompt phrasing and emphasis in instruction files
·Supports Claude Code slash commands and tool use patterns

Cursor

Cursor IDE

Cursor reads .mdc instruction files. ContextForge installs Cursor-specific adapted instructions from each pack's cursor.mdc file into .contextforge/agents/cursor/.

Root pointer file

No root file

Instruction directory

.contextforge/agents/cursor/

·No root pointer file for Cursor — instructions are in .contextforge/agents/cursor/
·Each pack's cursor.mdc is adapted for Cursor's instruction format

GitHub Copilot

GitHub Copilot in VS Code and other editors

GitHub Copilot instructions are stored in .contextforge/agents/copilot/. Each pack's copilot.md is installed there.

Root pointer file

No root file

Instruction directory

.contextforge/agents/copilot/

·No root pointer file for Copilot
·Each pack provides a copilot.md adapted for Copilot's instruction style

Example AGENTS.md

This is what ContextForge writes to AGENTS.md at your project root. The real instructions are in the linked directories.

AGENTS.md

# Project Agent Instructions

<!-- contextforge:start -->

ContextForge is installed for this repo.

Before working, read the relevant instruction files in:

- `.contextforge/agents/codex/`
- `.contextforge/skills/`

Follow the installed packs listed in `.contextforge/config.json`.
Do not copy these instructions into this file.

<!-- contextforge:end -->

Selecting tools

You choose which tools to configure during init. You can change this later with:

bash

# Re-init with different tool selection
npx @contextforge/cli init --tools codex,claude

# Or sync after manually editing config.json tools array
npx @contextforge/cli sync

Next: Sync & Doctor