Core concepts

Compatibility

Use Agent Needle with Codex, Claude Code, and AGENTS.md-compatible agents.

Agent Needle is a repository convention, not a hosted integration. Compatibility depends on whether an agent reads repository instructions.

Codex

The canonical Agent Needle README lists Codex among the agents that use the AGENTS.md installation. Copy the required files to the project as described in Getting started.

Claude Code

Include CLAUDE.md alongside AGENTS.md:

CLAUDE.md
@AGENTS.md

The adapter keeps AGENTS.md canonical while exposing the same instructions to Claude Code.

Other compatible agents

Any tool that respects AGENTS.md can use the core installation directly. Agent Needle supplies a Claude Code adapter; compatibility with other instruction filenames must be verified against the host tool.

What is portable

  • Markdown memory files
  • The retrieval and verification model
  • Active-work handoffs
  • Execution and safety discipline

Tool-specific permissions, sandbox behavior, and instruction precedence remain controlled by the host agent. Agent Needle does not override them.