FrameKeeper

Keep earlier images usable throughout long-running agent work.
Images can leave the current context and remain part of the task.
Automatic management. Original images on demand.

English · 简体中文 · 日本語

https://github.com/user-attachments/assets/aeb90ea2-6cb9-4f7a-9db7-8b4cd382430e

简体中文视频 · 日本語動画

Images stay part of the task

An image can leave the current request without losing its place in the task. In Codex and Claude Code, FrameKeeper preserves the link between images, visual details and your feedback:

• Find the right reference: stable image IDs, visual descriptions and your feedback help the model identify an image discussed earlier.
• Inspect the original: when details matter, the model retrieves the original image on demand and looks again.
• Continue after compaction: the image index survives conversation compaction, so earlier originals remain identifiable and retrievable.

Automatic by default. Keep working. Use it for image and video creation, scanned documents, computer and browser use, or everyday visual chats. It works even if you never open the panel or pick images yourself.

Install

Send this to your agent. It identifies its platform and installs the right setup:

Install FrameKeeper for me, following https://github.com/chipfighter/framekeeper/blob/main/INSTALL.md

Then restart the agent (in Claude Desktop, start a new Code session). See supported agents and installation, updates and uninstall.

The panel, when you want control

• Find an image by a detail or a comment you remember, like "rainy night" or "best face".
• Keep a reference in view: open an image and check Send every turn.
• Choose images yourself: turn off Auto-select and pick what goes with your next message.

In Codex, open Context Assets in the task's side panel. In Claude Desktop's Code tab, the panel opens automatically when there are images; type /cam to bring it back.

Privacy

FrameKeeper runs locally. Your original images and chat history stay on your computer; requests go to the service your agent already uses.

How we tested

We tested image-heavy conversations in Codex and Claude Code, including finding earlier images after long chats and compaction. See the Codex comparison and Claude Code long-task comparison for the results and reproduction steps.

Works with

Auto-select works across the agents below. Codex and Claude Desktop also include the panel.

Agent	What it is	Support
Codex	OpenAI's coding agent, desktop and CLI	Auto-select + panel, tested
Claude Code	Anthropic's coding agent, desktop and CLI	Auto-select + panel (desktop), tested
WorkBuddy	Tencent's desktop AI work assistant, with CodeBuddy inside	Auto-select, new, feedback welcome
OpenCode	Open-source terminal coding agent for any model provider	Auto-select, new, feedback welcome
Gemini CLI	Google's open-source terminal agent	Auto-select, new, feedback welcome
pi	Minimal, extensible terminal coding agent	Auto-select (pi extension), new, feedback welcome
DeepSeek Harness	DeepSeek's agent harness where everything is a plugin	Auto-select (dsh plugin), new, feedback welcome
Qwen Code	Qwen's open-source terminal agent	Auto-select, new, feedback welcome
Cline	Open-source coding agent for VS Code, JetBrains and the terminal	Auto-select, new, feedback welcome
Kilo Code	Open-source coding agent for VS Code, JetBrains and the terminal	Auto-select, new, feedback welcome
goose	Open-source agent for desktop and terminal, extended with MCP	Auto-select, new, feedback welcome
Cherry Studio	Open-source desktop chat client for many models	Auto-select, new, feedback welcome
Your agent	A thin adapter; the core stays as it is	Send a PR and add your agent here: ADAPTERS.md

Want to connect your own agent? Build an adapter, send a PR and add your platform to this list. For setup instructions, see INSTALL.md.

_{Changelog · Contributing · MIT License}