ajshedivy/agno-cookbook/agentos-api-memory
Claude Code and agent skill by ajshedivy/agno-cookbook
- community
Checking that the SKILL.md file is still in the repository.
Interact with AgentOS Memory API endpoints. For standard operations (listing, creating, updating, deleting memories, searching, topics), use the provided CLI script first. Only write custom Python when the script cannot handle the use case (e.g., advanced filtering, stats, chaining multiple calls, integration tests). Trigger when: managing user memories, writing scripts to manage user preferences, creating memory tests, or asking things like "what memories does this user have?" or "add a preference for dark mode."
Install
npx vskill@latest install ajshedivy/agno-cookbook/agentos-api-memorySKILL.md
The same SKILL.md was published earlier as ajshedivy/agno-cookbook/agentos-api-memory.
AgentOS Memory API
Use agno.client.AgentOSClient to create, list, update, and delete user memories on a remote AgentOS instance. Memories persist user preferences and facts across sessions.
Prerequisites
Start an AgentOS server with memory enabled:
Default: Use the CLI Script
Always try the provided script first. It covers listing, searching, creating, updating, and deleting memories — plus listing topics — all from the command line with no custom code needed.
The script is at: scripts/manage_memories.py
List all memories for a user
Search memories by content
Create a new memory
Get a specific memory
Update a memory
Delete a memory
List all memory topics
Use a different server
Full CLI reference
When to Write Custom Python
Only write ad-hoc Python when the CLI script cannot handle your use case:
- Advanced list filtering (by
agent_id,team_id, topic filters, pagination, sorting) - Memory stats (
get_user_memory_stats) - Chaining multiple memory calls in a single script
- Custom error handling or retry logic
- Integration tests that assert on memory content
- Programmatic lifecycle orchestration (create-then-update flows)
API Endpoints
| Method | Path | Description | |
|---|---|---|---|
| GET | /memories | List memories (paginated, filterable) | |
| GET | /memories/{memory_id} | Get memory by ID | |
| GET | /memories/topics | Get all memory topics | |
| GET | /memories/stats | Get user memory stats | |
| POST | /memories | Create a memory | |
| PATCH | /memories/{memory_id} | Update a memory | |
| DELETE | /memories/{memory_id} | Delete a memory |
Custom Python Examples
List Memories with Advanced Filtering
The list endpoint supports filtering beyond what the CLI provides:
Get User Memory Stats
Retrieve aggregated memory statistics:
Full Memory Lifecycle (Programmatic)
Chain multiple calls when you need create-then-verify flows:
Memory vs Storage
- Memory: User preferences and facts ("what do I know about you?") — persists across sessions
- Storage/Sessions: Conversation history ("what did we discuss?") — tied to a session
Anti-Patterns
- Don't write custom Python for basic operations — use the CLI script
- Don't forget `user_id` — memories are scoped to users
- Don't skip topics — topics enable filtering and categorization
- Don't store conversation content as memories — use sessions for that
- Don't forget `update_memory_on_run=True` on agents — required for automatic memory creation
- Don't assume topics/stats endpoints exist — they're optional and may not be available on all instances
Further Reading
For advanced memory API patterns, read references/api-patterns.md.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/agno-agentos-api/skills/agentos-api-memory/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ajshedivy/agno-cookbook/agentos-api-memory)