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.