n-WN/prompt-manager

다양한 AI 코딩 어시스턴트(AI coding assistants)의 프롬프트(prompts)를 관리하고 검색할 수 있는 TUI(Terminal User Interface) 도구입니다.

• 다음으로부터 대화 로그를 파싱(Parse) 및 인덱싱(index)합니다:

• Claude Code (JSONL 로그)

• Cursor (Protobuf가 포함된 SQLite)

• Codex CLI (세션 롤아웃)

• Aider (마크다운(markdown) 로그)

• Gemini CLI (세션 JSON)

• Amp CLI (스레드(thread) JSON)

• 모든 프롬프트에 대한 전체 텍스트 검색 (Full-text search)

• 소스/프로젝트/세션별 트리 기반 탐색 (Tree-based navigation)

• 마크다운 렌더링(Markdown rendering)을 통한 프롬프트 및 응답 미리보기

• 빠른 액세스를 위한 즐겨찾기 프롬프트 별표(Star) 표시

• 대화를 이어가기 위한 세션 포크(Fork)

• 증분 동기화 (Incremental sync, 변경된 파일만 처리)

Python 3.11+ 및 uv가 필요합니다.

git clone https://github.com/gengdz/prompt-manager.git
cd prompt-manager
uv sync

# TUI 실행
uv run pm
# 또는 직접 실행
...

uvx git+https://github.com/n-WN/prompt-manager.git

uv tool install git+https://github.com/n-WN/prompt-manager.git
pm
#또는
...

키(Key)	동작(Action)
ctrl+p	커맨드 팔레트 (Command palette)
?	도움말 (Help)
/	검색 포커스 (Focus search)
1-5	소스별 필터링 (전체/Claude/Cursor/Aider/Codex)
m	Amp 필터링
g	Gemini CLI 필터링
6	별표 표시된 항목 필터링
s	새 프롬프트 동기화 (Sync)
r	데이터베이스 재구축 (Rebuild database, 강제 재임포트)
ctrl+r	뷰 새로고침 (Refresh view)
c / y	선택된 프롬프트 복사
f	세션 포크 (Fork session)
Enter	전체 상세 정보 보기
q	종료 (Quit)

Prompt Manager는 ~/.prompt-manager/prompts.duckdb에 로컬 DuckDB 인덱스를 유지합니다.

새 버전으로 업그레이드할 때(특히 파싱이나 저장 방식이 변경되는 경우), 기존 로그가 다시 임포트되도록 인덱스를 재구축하십시오:

• TUI에서: r을 누르고 재구축을 확인합니다. - 또는 CLI를 통해: pm rebuild를 실행합니다.

참고 사항:

s는 증분 동기화(incremental sync)입니다 (보통 몇 초 소요; 변경된 파일만 처리). r은 전체 재구축(full rebuild)입니다 (몇 분이 소요될 수 있음; 모든 내용을 삭제하고 다시 임포트). s 실행 중 많은 skipped 파일이 보이는 것은 정상입니다. 이는 해당 로그들이 변경되지 않았음을 의미합니다.

업그레이드 후 시작 속도가 느려진다면, 오래되었거나 매우 큰 데이터베이스(또는 큰 .wal 파일)가 있을 수 있습니다. 다음 명령어로 검사 및 정리할 수 있습니다:

pm db-info

pm db-clean

dry-run 옵션을 사용하여 실제로 삭제하기 전에 테스트할 수 있습니다:

pm db-clean --yes

(이 명령어는 ~/.prompt-manager 디렉터리 내의 오래된 DB/WAL 파일을 삭제합니다.)

• 데이터베이스:
  ~/.prompt-manager/prompts.duckdb

• 다음 경로에서 파싱됨:
  ~/.claude/projects/ (Claude Code)
  ~/.cursor/chats/ (Cursor)
  그리고 Cursor의 globalStorage state.vscdb

~/.codex/sessions/ (Codex)
~/.aider.chat.history.md (Aider)
~/.gemini/tmp/**/chats/ (Gemini CLI)
~/.local/share/amp/threads/ (Amp)

• 빠르고 로컬한 스토리지를 위한 DuckDB
• 터미널 UI를 위한 Textual
• 마크다운 렌더링을 위한 Rich

MIT