CLI

외부 서비스 종속성 없이 대화형 대화를 위해 stdin/stdout으로 터미널에서 PRX를 직접 사용합니다.

사전 요구 사항

• PRX가 설치되고 하나 이상의 LLM 프로바이더가 설정되어 있어야 합니다
• stdin/stdout을 지원하는 터미널

빠른 설정

1. 설정

CLI 채널은 기본적으로 활성화되어 있습니다. 추가 설정이 필요하지 않습니다.

[channels_config]
cli = true  # 기본값, 생략 가능

2. 시작

prx

PRX가 대화형 모드로 시작되어 stdin에서 읽고 stdout에 응답을 출력합니다.

3. 사용법

메시지를 입력하고 Enter를 누릅니다. 특수 명령:

> Hello, how are you?
[PRX가 응답합니다...]

> /quit    # 세션을 종료합니다
> /exit    # 세션을 종료합니다 (대안)

설정 레퍼런스

필드	타입	기본값	설명
cli	bool	true	CLI 대화형 채널을 활성화 또는 비활성화합니다

기능

• 무 종속성 -- LLM 프로바이더 외에 외부 계정, 토큰, API가 필요하지 않습니다
• 항상 사용 가능 -- 기본적으로 활성화되어 있으며 설치 후 즉시 작동합니다
• stdin/stdout 인터페이스 -- 쉬운 스크립팅 및 파이핑을 위한 표준 Unix I/O
• 빈 줄 필터링 -- 빈 줄은 자동으로 무시됩니다
• 우아한 종료 -- /quit 또는 /exit를 입력하여 세션을 깨끗하게 종료합니다
• 전체 도구 접근 -- 설정된 모든 도구 (shell, file, browser, memory 등)를 사용할 수 있습니다

제한 사항

• 단일 사용자, 단일 세션만 지원합니다
• 세션 간 대화 기록이 유지되지 않습니다 (전역적으로 세션 지속성이 활성화된 경우 제외)
• 미디어 또는 파일 첨부를 지원하지 않습니다 (텍스트 전용 입력)
• 스트리밍/점진적 출력이 없습니다 (생성 완료 후 전체 응답이 출력됩니다)
• 명시적으로 설정하지 않는 한 동일 프로세스에서 다른 채널과 동시에 실행할 수 없습니다

문제 해결

PRX가 CLI 모드로 시작되지 않음

• [channels_config]에서 cli = true인지 확인합니다 (기본값이 true이므로 생략해도 됩니다)
• 다른 채널이 설정되어 있으면 PRX가 해당 채널을 우선할 수 있습니다; 시작 로그를 확인합니다
• 하나 이상의 LLM 프로바이더가 설정되어 있는지 확인합니다

입력이 처리되지 않음

• PRX가 실행 중인 터미널에서 입력하고 있는지 확인합니다 (백그라운드 프로세스가 아닌)
• 빈 줄은 무시됩니다; 비어 있지 않은 메시지를 입력합니다
• stdin이 연결되어 있는지 확인합니다 (/dev/null에서 리디렉션되지 않아야 함)

파이프와 함께 CLI 사용 방법

• PRX는 stdin에서 줄 단위로 읽으므로 입력을 파이프할 수 있습니다:

  echo "What is 2 + 2?" | prx

• 스크립트를 통한 멀티 턴 대화는 FIFO 또는 expect 기반 접근 방식을 사용합니다