Global behavior
AGENTS.md holds durable rules that should apply across projects: verify before stating, fix root causes, respect approval boundaries, and communicate like a human.
Back to homeOPEN SOURCE · CODEX + CLAUDE · MIT
Agent Brain
The files I use to work with coding agents: one shared operating brain, focused workflows, and adapters for Codex and Claude Code.
bash <(curl -fsSL https://dormizrahi.com/install)macOS or Linux · Codex, Claude Code, or both · Existing matching files are backed up first.
One brain, two runtimes
AGENTS.md is the canonical source. Codex reads it directly. Claude gets a tiny CLAUDE.md that imports it and adds only Claude-specific wiring.
Source of truth
~/.codex/AGENTS.mdCollaboration rules, verification discipline, approval boundaries, communication style, and information ownership.
Claude adapter
~/.claude/CLAUDE.mdImports the canonical brain and describes only Claude's skill and style-hook wiring.
On-demand workflows
~/.agents/skills/ + ~/.claude/skills/The same four procedures are exposed to both agents without bloating every conversation.
Where every kind of truth lives
Project behavior
A project AGENTS.md contains only unusual local rules and pointers. A project CLAUDE.md imports it instead of duplicating it.
Operational facts
Code, configuration, migrations, logs, and live inspection remain authoritative. The brain tells the agent to look; it does not cache facts that will rot.
Current work
The project's existing sprint, session, issue tracker, or handoff system owns status. Agent Brain follows the project's existing structure.
Reusable procedure
Skills hold conditional workflows. They load when their trigger matches instead of living in the global context on every turn.
Four workflows, no command theatre
Claude exposes these as slash commands. Codex can invoke them naturally or through a skill mention.
init-projectInitializes or audits lean project instructions. It verifies the repository first and does not create a brain folder unless the project already owns one.
sprintTurns an outcome into bounded, ordered work using the planning format the project already has.
handoffCaptures verified progress, failures, changed state, and the exact next action in the project's existing session system.
orient-statusAnswers “what are we doing?” from current evidence instead of paraphrasing stale conversation memory.
What changes in the agent
Evidence before confidence
Claims about files, runtime behavior, tests, and external facts must come from something inspected or run. Unknowns stay labeled unknown.
Outcome before implementation
The agent establishes what the user is trying to achieve before choosing a technical mechanism.
Autonomy with real boundaries
Safe reads, diagnostics, and approved local work continue without ceremony. Pushes, deployments, destructive deletion, purchases, and messages to others still wait for explicit approval.
Plain communication
The style layer leads with the answer and removes filler without reducing English to cryptic fragments.
Exactly what gets installed
| Path | Owner |
|---|---|
| ~/.codex/AGENTS.md | Canonical global brain |
| ~/.claude/CLAUDE.md | Thin Claude adapter |
| ~/.agents/skills/<skill>/ | Shared Codex skill copies |
| ~/.claude/skills/<skill>/ | Claude skill copies |
| ~/.claude/rules/conversation-style.md | Full Claude response-style rule |
| ~/.claude/hooks/conversation-style-*.js | Session and per-prompt style reinforcement |
| ~/.claude/settings.json | Two hook entries merged; other settings preserved |
| ~/.agents/backups/agent-brain-install-*/ | Pre-install copies of replaced files |
What it deliberately does not do
- ✓It does not copy Dor's client instructions, project lists, audit archives, credentials, or personal work history.
- ✓It does not enable bypass-permissions or change any existing permission mode.
- ✓It does not install notification sounds, send messages, connect accounts, push code, or deploy anything.
- ✓It contains only the public brain files shown on this page.
Install it only after you understand it
The installer asks three personalization questions, prints every destination, backs up matching files, and then writes the package. Read the source or run it locally first if you want to inspect every line.
bash <(curl -fsSL https://dormizrahi.com/install)