Jia-Ethan/grok-keysmith

해결하는 문제

grok-keysmith 는 Grok Build 의 사용자 지정 지침(홈 규칙)을 안전하게 관리하기 위해 설계된 배포 도구입니다. 사용자가 AGENTS.md 와 같은 중요한 파일을 수동으로 편집하지 않고도 전역 구성에 대한 변경 사항을 배포하고 검증하며 되돌릴 수 있게 해줍니다.

작동 방식

이 도구는 ~/.grok 디렉터리 내의 특정 파일을 관리합니다. 새로운 Grok 세션에서 이 규칙들을 로드할 수 있도록 Markdown 파일을 ~/.grok/rules/99-keysmith.md 로 배포합니다. 안정성을 보장하기 위해 config.toml 에 호환성 격리 블록을 삽입하고, 기존 훅은 ~/.grok/hooks/*.json 디렉터리를 .json.disabled 로 이름을 바꿔 비활성화합니다.

"미리 보기 우선" 접근 방식을 따르며, 디스크에 변경 사항을 커밋하려면 명시적인 --yes 플래그가 필요합니다. 또한 구성의 편차를 복구하고, 훅을 복원하며, 배포된 규칙을 완전히 제거하는 기능도 제공합니다.

대상 사용자

사용자 지정 지침을 통해 AI 에이전트의 전역 동작을 커스터마이징하고 싶으면서도 백업과 안전한 롤백 메커니즘을 유지하고 싶은 Grok Build 개발자 및 고급 사용자.

주요 기능

• 안전한 배포: 디스크에 쓰기 전에 드라이런 미리 보기 제공.
• 비파괴적: AGENTS.md 를 수정하지 않고, 대체된 파일의 백업을 생성.
• 구성 관리: config.toml 의 격리와 훅 비활성화를 통해 충돌을 방지.
• 되돌릴 수 있음: 훅 복원 및 배포 완전 제거를 위한 전용 명령어 제공.
• 크로스 플랫폼: macOS, Linux, Windows 지원 (Python 3.8+).
• 세션 스크립팅: run --session-script 기능을 통해 다중 대화를 하나의 Grok 세션에 전달 가능.