Give agents instructions for a project
Instructions are notes for your agents that apply to the whole project. Use them for anything you’d otherwise repeat in every conversation, like “commit changes after every change” or “explain what you changed in plain language, without code.”
Steps
Select Project settings
It’s the sliders, the last of your project’s tabs under the shelf at the top of the list column. On a phone, or in a narrow window, go back to the list first if something you opened fills the window.
Expand Instructions
Select Instructions. Beside it, None means the project has no instructions yet, and Custom means it has some.


Write your instructions
Type them in the box. Short, specific instructions work best.
Select Save
Agents in this project follow the new instructions from their next message.
Good to know
- Instructions apply to every conversation in the project, whichever agent you use. Agents receive them when they start working in a conversation, and again after you change them.
- You can also ask an agent in the project to change them, such as “Add to the project instructions: commit when you finish a task.” It changes them as if you’d saved them here, and every agent in the project follows them from its next message. To change another project’s, ask JOY. If someone changes them while the agent is working, the agent’s change is refused rather than replacing theirs.
- To remove all instructions, select Clear instructions, then Save.
- Enjoy keeps the instructions with the project’s conversations and documents, not in the project folder.
- Claude Code, Codex, and Muse Code also read instruction files kept in the project folder:
CLAUDE.mdfor Claude Code,AGENTS.mdfor Codex, andAGENTS.md, orCLAUDE.mdwhen there’s noAGENTS.md, for Muse Code. Those keep working in Enjoy. Use them if you also run the agent outside Enjoy, or want the instructions saved with the project’s files. - In the web app, you can edit instructions the same way. In the iPhone app, open the project’s Project settings, the sliders at the end of its section tabs, and edit them under Instructions; they’re saved when you leave the field.
- For ideas on what to write, see Write instructions your agent will follow.