deep-agents-memory

Route Deep Agent file and memory operations between ephemeral and persistent backends.

Updated May 26, 2026
One-click install
npx skills add https://github.com/anukkrit149/anukkrit-skills --skill deep-agents-memory-anukkrit149
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-agents-memory
Source: https://github.com/anukkrit149/anukkrit-skills/tree/main/cloud/skills/deep-agents-memory
Command: npx skills add https://github.com/anukkrit149/anukkrit-skills --skill deep-agents-memory-anukkrit149

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Agents often need both fast, thread-scoped working memory and durable, cross-session persistence, but teams struggle to set up consistent backend routing for files and memory operations.

Core Features & Use Cases

  • Ephemeral thread memory (StateBackend): Keeps temporary working files only for the lifetime of a thread.
  • Persistent cross-thread memory (StoreBackend): Maintains long-term storage across sessions and threads.
  • Hybrid path routing (CompositeBackend): Routes different filesystem paths to different backends (ephemeral vs persistent) to match real workflows.
  • FilesystemMiddleware tools: Enables common file operations like ls, read_file, write_file, edit_file, glob, and grep.

Use case: You want an agent to draft scratch files during a conversation, but permanently store user preferences under a dedicated folder so later threads can retrieve and reuse them.

Quick Start

Configure your Deep Agent to use CompositeBackend so paths under /memories/ persist while other paths remain ephemeral for the current thread.

Frequently Asked Questions about deep-agents-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist agent memory across multiple sessions?▼

To persist agent memory across multiple sessions, configure a StoreBackend for durable, cross-thread storage. This maintains long-term memory and files so later sessions can retrieve and reuse them.

What is the best way to separate temporary scratch files from permanent agent memory?▼

The best way to separate temporary scratch files from permanent agent memory is to use a CompositeBackend for hybrid path routing. It directs different filesystem paths to ephemeral or persistent backends based on path prefixes.

Can I use standard file operations like read and write with a custom memory backend?▼

Yes, you can use standard file operations like read and write with a custom memory backend by configuring FilesystemMiddleware. This enables ls, read_file, write_file, edit_file, glob, and grep tools to operate with the correct persistence behavior.

When do I need ephemeral thread-scoped state for deep agents?▼

You need ephemeral thread-scoped state for deep agents when you want temporary working files to exist only for the lifetime of a single thread. StateBackend handles this by keeping fast, thread-scoped working memory without persistence.

Does composite routing support different path prefixes for ephemeral and persistent storage?▼

Yes, composite routing supports different path prefixes for ephemeral and persistent storage. CompositeBackend allows you to route paths like /memories/ to persistent storage while keeping other paths ephemeral for the current thread.