<p align="center">
<img src="https://raw.githubusercontent.com/chipfighter/context-attachment-manager/HEAD/plugin/assets/logo.png" width="96" height="96" alt="">
</p>
<h1 align="center">Context Attachment Manager</h1>
<p align="center"><b>Codex, Claude Code 및 기타 에이전트에서 이미지 기반 채팅을 위한 로컬 플러그인입니다.</b><br>이전 이미지가 메시지를 보낼 때마다 함께 전송되는 것을 방지합니다. 모델은 대화가 압축된 후에도 필요한 이미지를 ID를 통해 가져옵니다.</p>
<p align="center">
<a href="https://github.com/chipfighter/context-attachment-manager/releases"><img src="https://img.shields.io/github/v/release/chipfighter/context-attachment-manager?include_prereleases" alt="Release"></a>
<img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey" alt="Platform: Windows, macOS, Linux">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a>
</p>
<p align="center"><b>English</b> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a></p>
<p align="center">
<img src="https://raw.githubusercontent.com/chipfighter/context-attachment-manager/HEAD/docs/images/loop.gif" alt="15개의 키프레임이 있는 작업 패널. 자동 선택(auto-select)을 켜면 이전 이미지가 회색으로 변하고 다음 요청이 7.5 MB에서 1.7 MB로 감소합니다." width="100%">
</p>
작동 방식 (What it does)
에이전트는 일반적으로 매번 모든 이전 이미지를 다시 전송하기 때문에, 많은 이미지가 포함된 긴 채팅은 느려지거나 진행이 멈출 수 있습니다. 이 플러그인은 각 이미지에 번호(IMG-001, IMG-002 등)를 부여하고, 이전 이미지는 짧은 플레이스홀더로 대체하여 전송합니다:
- 모델이 필요한 것을 가져옵니다: 모델이 이전 이미지를 다시 참조해야 할 때, ID를 통해 원본을 가져올 수 있습니다.
- 이미지를 구별할 수 있습니다: 모델은 각 이미지가 무엇을 보여주는지(사용자의 댓글 포함)에 대한 한 줄의 메모를 기록합니다. 이 정보는 대화가 압축된 후에도 플레이스홀더에 남아있습니다.
- 아무것도 삭제되지 않습니다: 사용자의 원본 이미지와 채팅 기록은 그대로 유지됩니다.
기본적으로 활성화되어 있어 패널을 열 필요가 없습니다. 일반적인 사용 사례는 이미지 및 비디오 생성, 스캔된 문서, 컴퓨터 및 브라우저 사용입니다.
설치(Install)
이 내용을 에이전트에게 전송하세요. 에이전트는 플랫폼을 식별하고 적절한 설정을 설치합니다:
https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md에 따라 Context Attachment Manager를 위해 설치해 줘.
그런 다음 에이전트를 재시작하세요 (Claude Desktop에서는 새 코드 세션을 시작). 지원되는 에이전트와 설치, 업데이트 및 제거를 참조하세요.
패널 (제어하고 싶을 때)
<p align="center">
<img src="https://raw.githubusercontent.com/chipfighter/context-attachment-manager/HEAD/docs/images/hero.png" alt="The panel: automatically manage earlier images, search by what you remember, and preview an image." width="100%">
</p>
Codex와 Claude Code는 테스트되었으며, Codex와 Claude Desktop 역시 패널을 갖추고 있습니다. 아래의 다른 에이전트들은 해당 코드와 문서를 기반으로 작성된 어댑터(adapters)를 통해 지원되지만, 아직 라이브 환경에서 테스트하지 못했습니다. 이들 중 하나를 사용하셨다면, 작동 여부와 관계없이 경험한 바를 알려주세요.
| Agent | 설명 (What it is) | 지원 상태 (Support) |
|---|
| Codex | OpenAI의 코딩 에이전트, 데스크톱 및 CLI | 자동 선택 + 패널, 테스트 완료 |
| ... | | |
| 설정 방법: 이들 에이전트를 위한 설정은 INSTALL.md를 참고하세요. 다른 에이전트를 연결하려면 ADAPTERS.md를 참조하세요. | | |
<p align="center"><sub><a href="CHANGELOG.md">변경 로그 (Changelog)</a> · <a href="CONTRIBUTING.md">기여하기 (Contributing)</a> · <a href="LICENSE">MIT 라이선스 (MIT License)</a></sub></p>
