⚡ Sangsakala Proxy 🏠 Home
Skip to content

About

Stop paying the multimodal tax. Your AI agent keeps every image it has seen but only sends the ones it needs: lighter chats, no endless reconnecting, no starting over. Works with Codex, Claude Code, Cline, Gemini CLI, OpenCode, WorkBuddy and more. Install once, forget it.

Topics

Resources

Contributing

Security policy

Stars

767 stars

Watchers

1 watching

Forks

Repository files navigation

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.

Release Platform: Windows, macOS, Linux License: MIT

English · 简体中文 · 日本語

FrameKeeper-v2-en.mp4

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

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

The FrameKeeper panel: automatically manage earlier images, search by what you remember, and preview an image.

  • 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

About

Stop paying the multimodal tax. Your AI agent keeps every image it has seen but only sends the ones it needs: lighter chats, no endless reconnecting, no starting over. Works with Codex, Claude Code, Cline, Gemini CLI, OpenCode, WorkBuddy and more. Install once, forget it.

Topics

Resources

Contributing

Security policy

Stars

767 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages