Configuration Reference

Agent Config

How to configure each agent CLI. File locations, formats, sections, and best practices — set up your agent once, use it everywhere.

Side-by-Side Comparison

Equivalent config files across different agent CLIs.

CLI	Config File	Location	Format
Claude Code	CLAUDE.md (or AGENTS.md)	Project root, ~/.claude/, or any parent directory	Markdown
Codex	AGENTS.md or .codex/config.json	Project root or ~/.codex/	Markdown (AGENTS.md) or JSON (.codex/config)
GitHub Copilot CLI	.github/copilot-instructions.md	Project root under .github/	Markdown
Gemini CLI	GEMINI.md	Project root or ~/.gemini/	Markdown
opencode	opencode.json / opencode.jsonc	Project root, ~/.config/opencode/, or ~/	JSON or JSONC
Cursor	.cursorrules	Project root	Markdown or plain text
Windsurf	.windsurfrules	Project root	Markdown or plain text
Amazon Q CLI	.amazonq/	Project root or ~/.amazonq/	Directory with YAML/JSON files