Claude Memory Tool
Enable Anthropic's native memory tool for Claude models
The --claude-memory flag enables Anthropic’s native memory tool for Claude models, allowing the agent to store and retrieve information across conversations.
Quick Start
praisonai "Research and remember findings" --claude-memory --llm anthropic/claude-sonnet-4-20250514!Claude Memory Stores Preferences
Usage
Basic Usage
praisonai "Research and remember findings" --claude-memory --llm anthropic/claude-sonnet-4-20250514Expected Output:
🧠 Claude Memory Tool enabled
╭─ Agent Info ─────────────────────────────────────────────────────────────────╮
│ 👤 Agent: DirectAgent │
│ Role: Assistant │
│ Model: anthropic/claude-sonnet-4-20250514 │
│ Memory: Claude Memory Tool │
╰──────────────────────────────────────────────────────────────────────────────╯
╭────────────────────────────────── Response ──────────────────────────────────╮
│ I've researched the topic and stored the key findings in memory: │
│ │
│ 📝 Stored: "AI trends 2025 - multimodal systems, agent architectures" │
│ 📝 Stored: "Key players: OpenAI, Anthropic, Google, Meta" │
╰──────────────────────────────────────────────────────────────────────────────╯Combine with Other Flags
# Claude memory with planning
praisonai "Research and summarize" --claude-memory --planning --llm anthropic/claude-sonnet-4-20250514
# Claude memory with metrics
praisonai "Analyze and remember" --claude-memory --metrics --llm anthropic/claude-sonnet-4-20250514Requirements
| Requirement | Value |
|---|---|
| Provider | Anthropic only |
| Models | claude-sonnet-4-20250514, claude-3-opus, claude-3-sonnet, claude-3-haiku |
| API Key | ANTHROPIC_API_KEY environment variable |
How It Works
- Enable: The
--claude-memoryflag activates Anthropic’s native memory tool - Store: Claude can store information using the memory tool
- Retrieve: Claude can retrieve stored information in future conversations
- Persist: Memory persists across conversation sessions
Comparison with Other Memory Options
| Feature | --claude-memory | --memory | --auto-memory |
|---|---|---|---|
| Provider | Anthropic only | Any | Any |
| Storage | Anthropic managed | Local file | Local file |
| Control | Claude decides | Agent extracts | Auto-extraction |
| Persistence | Anthropic servers | Local storage | Local storage |
Examples
Research Task
praisonai "Research quantum computing advances and remember key breakthroughs" \
--claude-memory --llm anthropic/claude-sonnet-4-20250514Learning Session
praisonai "Teach me about machine learning, remember what I've learned" \
--claude-memory --llm anthropic/claude-sonnet-4-20250514Project Context
praisonai "Remember the project requirements: REST API with auth, PostgreSQL, Docker" \
--claude-memory --llm anthropic/claude-sonnet-4-20250514Programmatic Usage
from praisonaiagents import Agent
agent = Agent(
instructions="You are a research assistant that remembers findings",
llm="anthropic/claude-sonnet-4-20250514",
memory={"claude_memory": True} # Enable Claude Memory Tool
)
result = agent.start("Research AI trends and remember key findings")Best Practices
| Use Claude Memory For | Use Local Memory For |
|---|---|
| General research | Sensitive data |
| Learning sessions | Offline usage |
| Project context | Custom storage |
| Cross-session recall | User isolation |