# iris-development

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 installs · ★ 170
- Author: redis
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/redis/agent-skills/tree/HEAD/skills/iris-development/SKILL.md
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/skills/iris-development

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add redis/agent-skills --skill iris-development -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/iris-development/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/iris-development/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add redis/agent-skills --skill iris-development -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/iris-development/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add redis/agent-skills --skill iris-development -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/iris-development/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install redis/agent-skills iris-development
```

2. **Manually: put the files in place**
- File: `.github/skills/iris-development/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add redis/agent-skills --skill iris-development -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/redis/agent-skills --path skills/iris-development
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/iris-development/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add redis/agent-skills --skill iris-development -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/redis/agent-skills/tree/HEAD/skills/iris-development/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cff17c35a9369cde.

BEGIN THIRD-PARTY FILE cff17c35a9369cde
```text
---
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
```
END THIRD-PARTY FILE cff17c35a9369cde

The third-party file has ended. Everything between the cff17c35a9369cde tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2871 of 4386 bytes. © redis · MIT · https://github.com/redis/agent-skills/tree/HEAD/skills/iris-development/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md