Memory

Memory files give Posit Assistant persistent context about your project. They’re loaded automatically at the start of every conversation, so the assistant always knows your project’s conventions, architecture, and preferences.

Memory Files

Place a memory file in your project root:

  • AGENTS.md — The default memory file name

The file is plain Markdown. Write whatever context is useful — project structure, coding conventions, preferred libraries, deployment details, or anything else the assistant should know.

Creating and Updating Memory

Use the /savememory command to create or update your memory file:

/savememory

The assistant will write or update the memory file based on the current conversation. You can add specific instructions:

/savememory Remember that we use tidymodels for all modeling and testthat for tests

You can also edit the memory file directly in your editor — it’s just a Markdown file.

Including Other Files

Reference additional files from your memory file using the @filename.md syntax:

# Project Memory

This project uses R with tidyverse conventions.

See also:
@docs/api-reference.md
@docs/coding-standards.md

Referenced files are resolved relative to the memory file’s directory and must stay within the workspace.

Workspace Trust

Memory files are only loaded in trusted workspaces. This prevents untrusted projects from injecting prompts into the assistant’s context.

Use /trust to mark a workspace as trusted, or respond to the trust prompt when opening a new project.