소개
Promptext는 소프트웨어 개발자가 작성한 코드 베이스를 AI 어시스턴트(Claude, ChatGPT 등)의 컨텍스트로 변환하도록 설계된 CLI 도구입니다. 1broseidon이 개발한 이 프로그램은 대규모 코드베이스를 분석하고, 관련성을 기준으로 파일을 필터링하며, 토큰 효율적인 형식으로 패키징하여 AI와의 작업 효율성을 높여줍니다.
상세정보
스마트 컨텍스트 추출
- 프로젝트 구조를 자동 분석하고, 불필요한 파일(바이너리, node_modules 등)을 필터링합니다.
- 파일명, 디렉토리 경로, import 구문, 파일 내용을 기반으로 관련성을 점수화하여 중요한 파일을 우선적으로 선택합니다.
- 사용자가 지정한 키워드에 따라 관련 파일을 필터링할 수 있습니다.
토큰 효율성 및 예산 관리
- cl100k_base 토크나이저(GPT-4, GPT-3.5, Claude 호환)를 사용하여 정확한 토큰 수를 계산합니다.
- 최대 토큰 예산을 설정하여 AI 컨텍스트 제한을 초과하는 것을 방지하고 API 비용을 절약합니다.
- PTX(기본값, 25-30% 절약), TOON-strict(30-60% 절약), 마크다운, XML 등 다양한 출력 형식을 지원합니다.
활용 방법
기본적인 사용법은 간단합니다. 프로젝트 디렉토리에서 명령줄을 열고 다음 명령어를 실행합니다.
- 현재 디렉토리 처리 및 클립보드 복사:
prx또는promptext - 특정 디렉토리 처리:
prx /path/to/project - 파일 확장자 필터링:
prx -e .go,.js,.ts - 파일 출력:
prx -o context.ptx또는prx -o project.xml - 키워드 기반 관련 파일 검색 및 토큰 예산 설정:
prx -r "auth login session" --max-tokens 8000
이런 경우에 유용합니다
- AI 코드 리뷰 및 분석: Claude나 ChatGPT에 프로젝트 전체 구조를 제공하여 종합적인 코드 분석을 받을 때.
- AI 페어 프로그래밍: GitHub Copilot, Cursor, Windsurf 등에 전체 컨텍스트를 제공하여 코드 작성 지원을 받을 때.
- 버그 조사 및 수정: 관련 파일들을 AI가 함께 분석하도록 할 때.
- 코드 마이그레이션 및 리팩토링: 레거시 코드베이스의 전체 맥락을 LLM에 제공할 때.
지원 환경·시스템 요구사항
Promptext는 Windows, macOS, Linux 시스템에서 사용할 수 있습니다. Windows 사용자는 PowerShell을 사용하여 설치 및 실행할 수 있습니다. Go 1.19 이상이 설치된 환경에서는 Go를 사용하여 직접 빌드 및 설치할 수도 있습니다.
최신 버전·업데이트
최신 버전은 0.6.2입니다. 프로그램은 하루에 한 번 새 릴리스를 자동으로 확인하고 업데이트 가능성을 알립니다. 업데이트는 다음 명령어로 수행할 수 있습니다.
- 업데이트 확인:
prx --check-update - 최신 버전으로 업데이트:
prx --update
제한 사항·확인 사항
- Promptext는 개발 및 AI 작업에 특화된 CLI 도구입니다.
- 설치 및 사용을 위해 기본적인 명령줄 사용법이 필요합니다.
시스템 요구사항
별도의 시스템 요구사항이 등록되지 않았습니다.


