codex-ops-kit/AGENTS.md

AGENTS.md

This repository is a portable Codex operations kit.

Goal

Keep Codex fast, cheap, and reusable across machines by separating:

• small persistent instructions
• portable memory notes
• heavyweight transient session data

Working Rules

• Treat this repo as the source of truth for reusable Codex setup.
• Keep AGENTS.md files short. Put durable user context in memory/*.md, not in giant prompt files.
• Prefer scripts in scripts/ for install, audit, export, and maintenance tasks.
• Never copy secrets, auth tokens, or large SQLite/session databases into Git.
• Default to dry-run behavior for cleanup scripts unless the user explicitly asks to apply changes.

Key Paths

• README.md: setup and rollout guide
• docs/research.md: research findings with source links
• templates/: portable Codex home templates
• memory/: durable cross-machine memory notes
• scripts/: audit, install, export, and maintenance tooling

Validation

• Shell scripts should pass bash -n.
• Python scripts should pass python3 -m py_compile.
• Prefer idempotent scripts so re-running them is safe.