Skip to main content
affpapa.org
RU EN
skill CX Codex

iris-development — Claude Code skill: agent memory on Redis Cloud

A skill for Redis Agent Memory: wire an AI agent to a persistent memory store on Redis Cloud, with session events and searchable long-term records.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add redis/agent-skills --skill iris-development -a claude-code
Open on GitHub

What iris-development does

The skill covers Redis Agent Memory (RAM), a managed memory service on Redis Cloud. Memory comes in two tiers: an append-only log of session events, and long-term records you can search by meaning. A background worker on the Redis Cloud side pulls durable facts out of a session and moves them into long-term memory.

Guidance lives in rule files under references/, split by area: service and token setup, session events, long-term memory, promotion. Code samples come in Python (redis-agent-memory) and TypeScript (@redis-iris/agent-memory); both expose a class named AgentMemory. The SDKs take the key from AGENT_MEMORY_API_KEY and the store ID from AGENT_MEMORY_STORE_ID.

You need a Redis Cloud account with a memory service provisioned and its store key issued first. Without AGENT_MEMORY_API_KEY the SDK cannot authenticate. The console shows the data-plane URL once the service is created.

What it helps with

  • attach persistent memory to an agent on Redis Cloud
  • append session events in the expected shape
  • search long-term memory with filters
  • bulk-load records without duplicate IDs
  • decide between session events and direct long-term writes

Example prompts for the agent

  • Show me how to append a session event with AgentMemory in Python
  • How do I search long-term memory filtered by ownerId?
  • Explain how background promotion extracts facts from a session

How to install iris-development

1Skills CLI (Vercel)

npx skills add redis/agent-skills --skill iris-development -a claude-code

2Manually: put the files in place

~/.claude/skills/iris-development/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/iris-development/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about iris-development

How do I install iris-development in Claude Code?

Run npx skills add redis/agent-skills --skill iris-development -a claude-code. The skill then lives at ~/.claude/skills/iris-development/SKILL.md.

What does iris-development do?

It gives the agent rules for Redis Agent Memory: provisioning a service, session events, long-term records and background promotion. Sample code in Python and TypeScript.

What does the skill need to work?

A memory service on Redis Cloud plus a store key. The SDKs read it from AGENT_MEMORY_API_KEY and take the store ID from AGENT_MEMORY_STORE_ID.

Source text

SKILL.md · MIT 
---
name: iris-development
description: Iris is Redis's umbrella for AI-focused products. Use this skill when integrating with the Iris Redis Agent Memory (RAM) data plane on Redis Cloud — recording session events for an AI agent, creating or searching long-term memories, configuring a memory store, or tuning background memory promotion. Code examples use the official `redis-agent-memory` (Python) and `@redis-iris/agent-memory` (TypeScript) SDKs.
license: MIT
metadata:
  author: redis
  version: "1.0.0"
---

# Iris: Redis Agent Memory

**Iris** is the umbrella brand for Redis's AI-focused products. This skill currently covers one product in that family: **Redis Agent Memory (RAM)** — the persistent memory layer for AI agents, delivered as a managed service on Redis Cloud. Additional Iris products will be added as separate sections when they ship.

Redis Agent Memory exposes a REST/JSON data-plane API with two memory tiers:

- **Session memory** — append-only conversation history per session (working memory).
- **Long-term memory** — semantically searchable records extracted from sessions (or created directly).

A background **promotion** worker — managed by Redis Cloud — extracts durable facts from session events and writes them into long-term memory.

## Official SDKs

All code samples use the official SDKs:


| Language   | Package                    | Class         | Install                            |
| ---------- | -------------------------- | ------------- | ---------------------------------- |
| Python     | `redis-agent-memory`       | `AgentMemory` | `pip install redis-agent-memory`   |
| TypeScript | `@redis-iris/agent-memory` | `AgentMemory` | `npm add @redis-iris/agent-memory` |


Both SDKs read the bearer token from `AGENT_MEMORY_API_KEY` and the default store ID from `AGENT_MEMORY_STORE_ID`. The production data-plane URL is `https://gcp-us-east4.memory.redis.io`; the exact URL for your service is also shown in the Cloud console after provisioning.

## When to Apply

Reference these guidelines when:

- Creating a memory service on Redis Cloud ([https://cloud.redis.io/#/agent-memory](https://cloud.redis.io/#/agent-memory))
- Wiring an agent to call `AgentMemory.add_session_event(...)` / `addSessionEvent(...)`
- Searching long-term memory with `search_long_term_memory(...)` / `searchLongTermMemory(...)`
- Choosing between session events and direct long-term memory writes

## Rule Categories by Priority


| Priority | Category                | Impact | Prefix       |
| -------- | ----------------------- | ------ | ------------ |
| 1        | Setup & Cloud Service   | HIGH   | `setup-`     |
| 2        | Session Memory / Events | HIGH   | `session-`   |
| 3        | Long-Term Memory        | HIGH   | `ltm-`       |
| 4        | Memory Promotion        | MEDIUM | `promotion-` |


## Quick Reference

### 1. Setup & Cloud Service (HIGH)

- [`setup-cloud-service`](references/setup-cloud-service.md) - Create a Memory service on Redis Cloud
- [`setup-auth-token`](references/setup-auth-token.md) - Authenticate the SDK with a store API key

### 2. Session Memory / Events (HIGH)

- [`session-when-to-use`](references/session-when-to-use.md) - Choose session events vs direct long-term memory
- [`session-add-event`](references/session-add-event.md) - Append a session event correctly
- [`session-retrieval`](references/session-retrieval.md) - Retrieve session memory and individual events

### 3. Long-Term Memory (HIGH)

- [`ltm-bulk-create`](references/ltm-bulk-create.md) - Create long-term memories in bulk with idempotent IDs
- [`ltm-search`](references/ltm-search.md) - Search long-term memory semantically with filters
- [`ltm-organize`](references/ltm-organize.md) - Organize records with namespace, ownerId, topics, and memoryType

### 4. Memory Promotion (MEDIUM)

- [`promotion-overview`](references/promotion-overview.md) - How background promotion works

## How to Use

Read individual rule files under `references/` for detailed explanations and code examples:

```
references/setup-cloud-service.md
references/session-add-event.md
references/promotion-overview.md
```

Each rule file contains:

- Brief explanation of why it matters
- Correct example(s) with Python and TypeScript SDK code
- Either an "Incorrect" example or "When to use / When NOT needed" guidance
- Additional context and references

© redis · MIT · redis/agent-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set8

redis-core A skill that tells your agent which Redis data type fits the job and how to name keys. Useful when you design a cache, counters or session storage. CX Codex +1 4,000installs redis-connections A skill that tells your coding agent how to configure a Redis client properly: connection pooling, pipelining, socket timeouts and client-side caching. CX Codex +1 2,800installs redis-security Guides Redis hardening with authentication, TLS, ACLs and network restrictions. Use it when deploying or auditing a production Redis instance. CX Codex +1 2,400installs redis-observability Tells your agent which Redis metrics to watch and which built-in commands to run when something looks off. CX Codex +1 2,300installs redis-semantic-cache This skill walks through putting LangCache in front of an LLM call, so a similar prompt returns a stored answer instead of hitting the model again. CX Codex +1 1,900installs redis-clustering Teaches the agent how to place keys across Redis Cluster slots and move read traffic off primaries. Useful when a CROSSSLOT error shows up or you are designing keys up front. CX Codex +1 1,800installs redis-search A skill that walks your agent through Redis Search: index schema, field types, FT.SEARCH queries and vector retrieval. Useful when building search or a RAG pipeline on Redis. CX Codex +1 1,600installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor