rapg은(는) 무엇을 하나요?
AI 에이전트 시대를 위한 로컬 우선 비밀 관리자 — API 키를 .env 파일과 에이전트 대화 기록에서 안전하게 보호합니다.
개요
kanywst/rapg는 AI 에이전트(예: Claude Code, Cursor, Codex)를 사용할 때 민감한 정보(예: API 키, 토큰, 비밀번호)를 안전하게 관리하기 위한 오픈 소스 도구입니다. 기존의 .env 파일이나 일반 텍스트로 비밀을 저장하는 방식 대신, rapg는 암호화된 로컬 저장소를 사용하여 비밀을 보호하고, 에이전트가 필요할 때만 안전하게 검색할 수 있도록 합니다.
주요 기능
- 로컬 우선 저장: 모든 비밀은 사용자의 로컬 시스템에 암호화되어 저장됩니다. 클라우드나 타사 서버에 데이터가 저장되지 않습니다.
- AI 에이전트 통합: Claude Code, Cursor, Codex와 같은 주요 AI 에이전트 도구와 원활하게 통합됩니다.
- 보안 강화: 비밀이 .env 파일이나 대화 기록에 노출되지 않도록 방지합니다.
- 간단한 CLI: 직관적인 명령줄 인터페이스를 통해 비밀을 쉽게 추가, 검색, 삭제할 수 있습니다.
- 오픈 소스: 코드가 공개되어 있어 보안 감사 및 커스터마이징이 가능합니다.
설치 방법
# npm을 사용하여 전역 설치
npm install -g rapg
# 또는 yarn 사용
yarn global add rapg
사용 방법
비밀 저장
rapg set OPENAI_API_KEY sk-your-api-key-here
비밀 검색
rapg get OPENAI_API_KEY
# 출력: sk-your-api-key-here
모든 비밀 목록 보기
rapg list
비밀 삭제
rapg delete OPENAI_API_KEY
AI 에이전트와 함께 사용하기
rapg는 AI 에이전트 환경에서 특히 유용합니다. 에이전트가 API 키를 필요로 할 때, 다음과 같이 사용할 수 있습니다:
# 에이전트 프롬프트 내에서 rapg를 호출하여 비밀을 검색
$(rapg get OPENAI_API_KEY)
이렇게 하면 비밀 값이 에이전트의 대화 기록에 직접 노출되지 않고, 안전하게 사용됩니다.
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
RAPG_STORAGE_PATH | 암호화된 저장소 파일 경로 | ~/.rapg/store |
RAPG_ENCRYPTION_KEY | 암호화 키 (선택 사항, 설정하지 않으면 자동 생성) | 없음 |
보안 고려사항
- 모든 비밀은 AES-256-GCM 암호화로 저장됩니다.
- 암호화 키는 로컬 시스템 키체인에 안전하게 보관됩니다.
- 비밀은 메모리에만 일시적으로 로드되며, 사용 후 즉시 삭제됩니다.
라이선스
MIT