Skip to main content

Project instructions

Outcome: Atomic loads your repository’s conventions automatically in every session. Prerequisites: First session is complete.

Give Atomic project instructions

Atomic loads context files at startup. Add an AGENTS.md file to tell it how to work in a project:
Atomic loads:
  • ~/.atomic/agent/AGENTS.override.md, AGENTS.md, or CLAUDE.md for global instructions (legacy ~/.pi/agent/ also works)
  • AGENTS.override.md, AGENTS.md, or CLAUDE.md from parent directories and the current directory
An AGENTS.override.md file replaces the other context files in its directory. Restart Atomic, or run /reload, after changing context files.

Verify Atomic loaded them

With AGENTS.md saved, run /reload (or restart Atomic), then ask:
The answer should restate your rules, such as the bun run typecheck line above, rather than give generic advice. If it does not, check that:
  • The file is named AGENTS.md.
  • It is in the directory where you started Atomic or one of its parents.
  • No AGENTS.override.md in the same directory replaces it.

Next step

Continue to Interactive use, then Configuration.