Jia-Ethan/codex-keysmith

Versioned Codex instruction deployment with preview, ownership manifests, hook isolation, scenario evaluation, and recovery.

codex‑keysmith – 로컬 Codex 클라이언트에 되돌릴 수 있는 지시 프롬프트 훅 추가하기

기능

로컬에 설치된 Codex 데스크톱 클라이언트 설정에 프롬프트 템플릿 (이를 keysmith 라고 함)을 쓰는 작은 Python 설치 프로그램 제공.
프로세스는 미리 보기 우선, 승인 후 적용이며 언제든지 롤백 가능.
Codex 바이너리에 손대지 않고, API 키를 읽지 않으며, 인터넷에 데이터를 전송하지 않습니다.

작동 방식

드라이런 / 미리 보기 – 스크립트는 대상 Codex 디렉터리를 스캔하고, 추가할 파일과 훅 코드의 정확한 내용을 표시하며, 검증을 위해 SHA‑256 체크섬을 출력합니다.
적용 – 승인 후 (--yes) 스크립트는 훅을 적절한 위치에 쓰고, 작은 매니페스트를 업데이트하여 새로운 Codex 대화에서만 새 동작이 활성화되도록 합니다.
재활성화 / 제거 – 나중에 원래 파일을 복원(--restore-hooks), 훅을 완전히 제거(--uninstall), 또는 이전에 저장한 상태를 재활성화(--reactivate)할 수 있습니다.

지원 플랫폼

macOS 및 Linux (공식 지원)
Windows (베타 채널, x64에서 테스트 완료)
Python 3.10+ 필요.

설치 단계

# 1. 최신 릴리스 스크립트 다운로드 (X.Y.Z를 태그로 바꾸세요)
base="https://github.com/Jia-Ethan/codex-keysmith/releases/download/vX.Y.Z"
curl -L "$base/codex-instruct-vX.Y.Z.py" -o codex-instruct.py
curl -L "$base/SHA256SUMS" -o SHA256SUMS
# 2. 체크섬 검증
awk '$2 == "codex-instruct-vX.Y.Z.py"' SHA256SUMS | shasum -a 256 -c -
# 3. 작성될 내용 미리 보기
python3 codex-instruct.py --codex-dir ~/.codex --dry-run --lang zh-CN
# 4. 만족하면 적용
python3 codex-instruct.py --codex-dir ~/.codex --yes --lang zh-CN

~/.codex를 실제 Codex 설치 디렉터리로 바꾸세요.

훅 제거

python3 codex-instruct.py --codex-dir ~/.codex --restore-hooks --lang zh-CN   # 원래 파일 복원
python3 codex-instruct.py --codex-dir ~/.codex --uninstall --yes --lang zh-CN # 훅 완전 제거

문서 및 도움말

자세한 사용법: docs/reference.md
다른 AI 어시스턴트가 설치하도록 요청하는 방법: docs/agent‑install.md
보안 고려사항: SECURITY.md
커뮤니티 토론: GitHub Discussions, LINUX DO 포럼.

라이선스

MIT 라이선스 – 자유롭게 사용, 수정, 재배포 가능.

왜 중요한가 codex-keysmith는 파워 유저가 로컬 Codex 코딩 어시스턴트의 동작을 안전하고 되돌릴 수 있는 방식으로 사용자 정의할 수 있게 해줍니다. 새로운 세션마다 실행되는 프롬프트를 삽입함으로써, 코딩 표준 강제, 프로젝트 고유의 컨텍스트 추가, 새로운 지시 세트 실험을 애플리케이션의 핵심을 변경하지 않고 가능하게 합니다.

Jia-Ethan/codex-keysmith

codex‑keysmith – 로컬 Codex 클라이언트에 되돌릴 수 있는 지시 프롬프트 훅 추가하기

관련