Windows용 Codex의 AgentMemory

OpenAI Codex Desktop 및 Codex CLI용 독립형 Windows 네이티브 AgentMemory 다운스트림.

English | 한국어 | 日本語

[!IMPORTANT] 이는 독립적인 소스 전용 기술 프리뷰입니다. AgentMemory v0.9.29를 기반으로 하지만, 공식 업스트림 저장소, @agentmemory/* npm 릴리스, 또는 업스트림 지원 약속이 아닙니다. 여기에 설명된 Windows 빌드 및 설치 프로그램 대신 업스트림 npx 명령이나 호환성 플러그인 매니페스트를 사용하지 마십시오.

개발 참고: 이 다운스트림은 AI가 생성하고 사용자가 테스트한 것입니다. 전체 공개를 읽어 주십시오.

이 프리뷰가 하는 일

AgentMemory는 공식 AgentMemory 메모리, 교훈, 그래프, 감사 및 출처 저장소만을 유일한 표준 저장소로 유지하면서 Codex 작업 전반에 걸쳐 유용한 컨텍스트를 보존합니다.

• 네 개의 관리형 Codex 훅(SessionStart, UserPromptSubmit, Stop, SessionEnd)을 통해 일반 메인 에이전트 사용자 프롬프트와 최종 어시스턴트 응답을 캡처합니다.

• 주변 UI, 제목/포크 트래픽, 알려진 내부 호스트 프롬프트 및 서브에이전트 트래픽을 영구 캡처에서 제외합니다.

• 쓰기, 삭제, 큐레이션 및 출처를 정확히 프로젝트 범위로 제한합니다.

• 와일드카드 쓰기를 허용하지 않으면서 프로젝트 간에 제한된 소스 라벨 연합 회상을 지원합니다.

• 유형화된 그래프 추출을 위해 자격 증명이 필요 없는 루프백 전용 로컬 Qwen 워커를 사용할 수 있습니다. 다른 모든 AgentMemory LLM 기능은 noop 공급자를 받으며 외부 폴백은 비활성화된 상태로 유지됩니다.

• Codex용 인증된 루프백 MCP 엔드포인트를 사용하며 패키징된 stdio 런처는 호환성 경로로만 유지합니다.

업스트림 호환 소스 표면에는 56개의 MCP 도구가 포함되어 있습니다. MCP 표면은 56개 도구, 6개 리소스, 3개 프롬프트이며, 포트 3111에 133개 엔드포인트, 12개 휴대용 훅, 17개 스킬도 있습니다. 지원되는 Windows 프로필은 의도적으로 위에 나열된 네 개의 관리형 훅만 활성화합니다.

Related MCP server: remem

버전 식별

정확한 업스트림 태그, 커밋, 트리 및 원본 패키지 해시는 upstream-source.json에 기록되어 있습니다.

요구 사항

• PowerShell 5.1 이상이 설치된 Windows; 이 프리뷰는 Windows 11에서 자격이 검증되었습니다

• Node.js 20 이상

• 저장소의 고정 패키지 관리자 선언을 통한 pnpm 11.19.0

• SHA-256이 packaging/windows-codex/config/third-party-inputs.json과 일치하는 공식 iii 엔진 0.11.2 Windows 실행 파일

첫 번째 소스 프리뷰에는 사전 빌드되거나 서명된 설치 프로그램이 첨부되어 있지 않습니다.

소스에서 빌드 및 평가

Windows에서 저장소를 클론한 다음 PowerShell에서 릴리스 빌더를 실행합니다. 출력 디렉터리는 이미 존재해서는 안 됩니다.

git clone https://github.com/M-T-D-N/agentmemory-codex-windows.git
Set-Location agentmemory-codex-windows

& .\packaging\windows-codex\Build-WindowsCodex.ps1 `
  -OutputDirectory D:\staging\agentmemory-codex `
  -IiiEnginePath D:\inputs\iii-0.11.2.exe

일반 빌더는 고정 네이티브 입력을 검증하고, 고정 잠금을 복원하고, 생성된 스킬을 확인하고, 타입 검사, 빌드, 패키지 및 Codex 어댑터 테스트를 실행하고, 프로덕션 종속성 트리를 생성하고, 완전한 불변 파일 매니페스트를 작성합니다.

설치 프로그램은 기본적으로 드라이런입니다. 변경하기 전에 릴리스 해시, 소유권, 경로 및 기존 설치를 검증합니다. -Execute를 사용하기 전에 packaging/windows-codex/README.md에서 정확한 빌드, 드라이런, 전환, 롤백, 보존 및 인증 계약을 검토하십시오.

[!WARNING] Windows 설치 프로그램은 소유되고 관리되는 AgentMemoryCodex 서비스 레이아웃을 위해 설계되었습니다. 관련 없는 디렉터리를 가리키거나 빌드 출력을 사용자 데이터로 취급하지 마십시오. 표준 data, 비밀, 로그, 작업 ID 및 롤백 상태는 독립적인 수명 주기를 갖습니다.

개인정보 및 보안 경계

• MCP 및 서비스 트래픽은 지원되는 프로필에서 인증된 루프백 엔드포인트에만 유지됩니다.

• 선택적 Qwen 공급자는 자격 증명이 없는 루프백 HTTP만 허용하며 그래프 추출로 기능 범위가 제한됩니다.

• 소스 트리에는 메모리 데이터베이스, 세션 기록, 사용자 내보내기, API 키, 생성된 설치 프로그램 또는 개인 개발 기록이 포함되어 있지 않습니다.

• 보안 보고는 GitHub의 비공개 취약점 보고 흐름을 사용해야 합니다. SECURITY.md를 참조하십시오.

저장소 맵

업스트림 마케팅 웹사이트, 클라우드 배포 예제, 기타 업스트림 언어 사본, 생성된 빌드 출력 및 비공개 모노레포 기록은 의도적으로 첫 번째 공개 저장소 스냅샷에 포함되지 않습니다. 과거 벤치마크 자료는 재현성 목적으로만 유지되며 업스트림 참조로 명시적으로 표시됩니다. 해당 디렉터리의 어떤 벤치마크 수치도 이 다운스트림 프리뷰에 대한 주장이 아닙니다.

개발 검사

pnpm install --frozen-lockfile
pnpm run skills:check
pnpm run typecheck
pnpm run build
pnpm test
node packaging/windows-codex/tests/codex-turn.test.mjs

저장소는 업스트림 @agentmemory/* 패키지 이름으로 실수로 게시되는 것을 방지하기 위해 패키지 매니페스트에서 private으로 표시되어 있습니다. 기여는 CONTRIBUTING.md를 따라야 하며, 다운스트림 릴리스 기록은 CHANGELOG.md에 있습니다.

AI 개발 공개

대부분의 다운스트림 수정 사항은 사용자 제공 요구 사항과 반복적인 승인 요청을 기반으로 OpenAI Codex가 생성하고 수정했습니다. 저장소 소유자는 소스 코드를 수동으로 검토하지 않았습니다. 검증은 소유자의 Windows/Codex 환경에서 자동화된 테스트와 실시간 기능 테스트를 기반으로 합니다. 독립적인 제3자 코드 또는 보안 감사는 수행되지 않았습니다.

요약: AI 생성, 사용자 테스트, 수동 코드 검토 없음.

업스트림 출처 표시 및 라이선스

이 다운스트림은 Rohit Ghumare 및 기여자들의 AgentMemory를 기반으로 합니다. 출처 표시와 정확한 소스 식별은 NOTICE 및 upstream-source.json을 참조하십시오. 코드는 Apache License 2.0에 따라 제공됩니다.