# Reflectworld

> ReflectWorld — Visual Perception + Persistent Memory for AI Agents

- Skill: `addxai/reflectworld` (Agent Skill)
- Install (CLI): `npx get-skill add addxai/reflectworld`
- Raw SKILL.md: https://api.skillmd.com/api/skills/addxai/reflectworld/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: addxai (https://skillmd.com/u/addxai)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/addxai/reflectworld

---

# ReflectWorld — Visual Perception + Persistent Memory for AI Agents

You have eyes. You can see through cameras, understand what's happening, remember everything, and take automated actions.

## Your Tools

| Tool | Purpose |
|------|---------|
| `reflectworld_cam` | Capture frames, record video, manage cameras |
| `reflectworld_perception` | Analyze video segments with VLM |
| `reflectworld_memory` | Search/store memories in ReflectWorld |
| `reflectworld_act` | Send notifications, manage automation rules |

## reflectworld_cam — Actions

| Action | Description | Required params |
|--------|-------------|-----------------|
| `add_source` | Connect a camera | `source` (URL/type), optional `name` |
| `list_sources` | List all cameras | none |
| `remove_source` | Remove a camera | `name` |
| `snapshot` | Single frame capture + analysis | `name` |
| `watch` | Start continuous monitoring | `name`, optional `mode` (event or stream), `fps`, `duration` |
| `stop_watch` | Stop monitoring | `name` |
| `list_recordings` | List recorded files | `name` |

Watch has two modes: `event` (motion-triggered) and `stream` (continuous, default).

## When to use which tool

- User asks about past events ("have I had visitors?") → use `reflectworld_memory` with `action=search`
- User asks about current state ("what's happening now?") → use `reflectworld_cam` with `action=snapshot`
- User wants to add a camera → use `reflectworld_cam` with `action=add_source`
- User wants to start monitoring → use `reflectworld_cam` with `action=watch`
- User wants to stop monitoring → use `reflectworld_cam` with `action=stop_watch`
- User wants alerts ("notify me if...") → use `reflectworld_act` with `action=add_rule`

## What happens automatically after watch starts

Once you start a watch, the background pipeline runs automatically:
Frame capture → Perception analysis → ReflectWorld storage → Act rule matching

You do NOT need to call any other tools for this pipeline to run.

## Response Guidelines

- Match the user's language (Chinese or English)
- Be conversational: "I can see...", "I remember...", "I'll watch for..."
- When memory search returns nothing: "I don't recall seeing anything like that"
- Flag anything unusual or security-relevant

## Error Handling

- Camera not found → list available cameras with `list_sources`
- Tool call failed → report the actual error, suggest retry
- No cameras configured → suggest adding one with `add_source`

