Skip to content

Memory

View and edit Claude Code's memory hierarchy — CLAUDE.md files, rules, auto-memory, and imports.

Overview

Claude Code uses a layered memory system where instructions are loaded from multiple files at different scopes. The Memory page provides four tabs:

  • Hierarchy — CLAUDE.md files across all scopes
  • Rules — path-scoped rule files
  • Auto-Memory — session-generated memory files
  • Imports — dependency tree of @path references

How to Use

Memory Hierarchy

The Hierarchy tab shows CLAUDE.md files organized by scope (highest to lowest priority):

ScopeFileDescription
ManagedEnterprise CLAUDE.mdOrganization-wide policy (read-only)
User~/.claude/CLAUDE.mdUser preferences and global instructions
Project.claude/CLAUDE.md or CLAUDE.mdTeam project instructions
Local.claude/CLAUDE.local.mdPersonal project overrides (not committed)

Click any memory file card to open the editor with markdown preview. Quick create buttons let you create missing files at any scope.

Rules

Rules are markdown files in .claude/rules/ with optional path-scoped frontmatter:

yaml
---
description: TypeScript formatting rules
paths:
  - "src/**/*.ts"
  - "src/**/*.tsx"
---
Use strict TypeScript. No `any` types.

Rules only apply when working on files matching the specified paths.

Auto-Memory

Session-based memory files that Claude Code auto-generates, stored in ~/.claude/projects/{project}/memory/. These persist learnings and preferences across sessions for each project.

Imports

The Imports tab shows the dependency tree of @path references across memory files:

markdown
<!-- In CLAUDE.md -->
@./docs/coding-standards.md
@~/global-rules.md

Import syntax:

  • @./relative/path — relative to current file
  • @~/user/path — relative to home directory
  • @/absolute/path — absolute path

The import viewer detects circular references and shows them as warnings.

Configuration

Memory files are standard markdown. No special Claude Deck configuration needed — the Memory page reads and writes directly to the filesystem.

Tips

  • Local files (.claude/CLAUDE.local.md) are for personal overrides — they're not committed to version control.
  • Managed files are read-only (enterprise-enforced).
  • Use rules with path patterns to apply instructions only to specific file types.
  • Auto-memory files are auto-generated — edit them to correct or refine Claude's learned preferences.

Released under the MIT License.