ZiChuanLan/agent-purge

어떤 프로젝트인가요?

핵심 기능

• 01설정 블록, PATH shim 또는 세션 내 명령을 통해 하나의 페르소나를 여러 코딩 에이전트에 적용합니다.
• 02replace, strict, append, off 모드를 제공하며 실행 중에도 전환할 수 있습니다.
• 03페르소나 목록과 하네스 상태를 확인하고 삽입을 켜거나 끌 수 있는 로컬 웹 콘솔을 제공합니다.
• 04제거, 비활성화 또는 off 모드 전환으로 모든 변경 사항을 되돌릴 수 있습니다.
• 05선택 사항인 magpie gateway 플러그인은 gateway를 통과하는 요청의 시스템 프롬프트를 다시 작성합니다.

활용 사례

• Claude Code, Codex, OpenCode에서 페르소나나 코딩 스타일을 일관되게 유지합니다.
• 시스템 프롬프트에 따라 코딩 에이전트의 동작이 어떻게 달라지는지 테스트합니다.
• 여러 에이전트가 로컬 gateway를 거치도록 구성하고 한곳에서 페르소나를 변경합니다.

빠른 시작

1. 1

   npm을 통해 CLI를 전역으로 설치합니다

   npm i -g agent-purge
2. 2

   로컬 웹 콘솔을 시작합니다

   agent-purge web
3. 3

   현재 페르소나로 코딩 에이전트를 실행합니다(예: codex)

   agent-purge codex

사용 전 알아둘 점

• !Node.js 20 이상이 필요합니다.
• !클로즈드 소스 데스크톱 에이전트는 있는 그대로만 실행되며 프롬프트를 주입할 수 없습니다.
• !선택 사항인 magpie 게이트웨이 플러그인은 git clone으로 설치해야 하며, 변경 후 페르소나 목록을 다시 생성해야 합니다.
• !strict 모드와 replace 모드에서는 도구 지침이 제거될 수 있어 하네스 동작이 저하되거나 달라질 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

agent-purge은(는) 무엇인가요?

Claude Code, Codex, OpenCode 같은 여러 코딩 에이전트에 공통 시스템 프롬프트(페르소나)를 삽입하거나 교체하는 로컬 웹 콘솔 및 CLI입니다. agent-purge는 codex, claude, opencode, pi, hermes 등 여러 코딩 에이전트 하네스의 시스템 프롬프트에 기록할 페르소나 파일 하나를 제공합니다. 하네스마다 시스템 프롬프트를 읽는 위치가 달라, 이 도구는 세 가지 적용 경로를 지원합니다. 하네스에 설치하는 관리형 설정 블록, 페르소나를 적용해 하네스를 실행하는 PATH shim, 적용을 켜거나 끄는 세션 내 슬래시 명령입니다. replace, strict(페르소나만 사용), append, off의 네 가지 모드를 사용할 수 있습니다.

agent-purge은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agent-purge은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agent-purge은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. agent-purge의 마지막 커밋은 2026년 11월 6일입니다.

agent-purge은(는) 어디에 사용할 수 있나요?

Claude Code, Codex, OpenCode에서 페르소나나 코딩 스타일을 일관되게 유지합니다. 시스템 프롬프트에 따라 코딩 에이전트의 동작이 어떻게 달라지는지 테스트합니다. 여러 에이전트가 로컬 gateway를 거치도록 구성하고 한곳에서 페르소나를 변경합니다.

agent-purge는 어떻게 설치하나요?

npm을 통해 CLI를 전역으로 설치합니다: npm i -g agent-purge 로컬 웹 콘솔을 시작합니다: agent-purge web 현재 페르소나로 코딩 에이전트를 실행합니다(예: codex): agent-purge codex

agent-purge은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ZiChuanLan/agent-purge