GPTScript CLI 레퍼런스 — gptscript 명령

GPTScript CLI 레퍼런스

gptscript 실행 파일은 단일 PROGRAM_FILE(보통 .gpt 파일)을 받아 그 안의 도구를 실행합니다. 인자 없이 실행하면 대화형 채팅(TUI)으로 들어가고, 파일 경로를 주면 그 스크립트를 돌립니다.

출처: GPTScript CLI Reference — 공식문서

주요 옵션

  • --default-model string — 사용할 LLM 모델(기본 gpt-4o), GPTSCRIPT_DEFAULT_MODEL 환경변수로도 설정.
  • --list-tools — 내장(built-in) 도구 목록을 뽑고 종료.
  • --list-models — 사용 가능한 모델 목록을 뽑고 종료.
  • --confirm — 위험한 명령을 실행하기 전에 확인을 요구.
  • --force-chat — 최상위 도구가 채팅 도구가 아니어도 대화형 세션을 강제.
  • --input, -f — 파일(- 는 stdin)에서 입력을 읽음.
  • --output, -o — 출력을 파일(또는 - 로 stdout)로 저장.
  • --workspace string — 작업 디렉토리; 지정하면 종료 후에도 삭제하지 않음.
  • --ui — 웹 UI 를 띄움.
  • --cache-dir — 캐시 디렉토리(기본 $XDG_CACHE_HOME/gptscript).
  • --chat-state — 이전 대화 상태를 이어서 새 채팅을 시작.

거의 모든 옵션은 $GPTSCRIPT_* 환경변수로도 지정 가능하며, OpenAI 호환 엔드포인트면 --openai-base-url/--openai-api-key 로 바꿔 끼울 수 있습니다.

실행 예

# 도구 목록 확인
gptscript --list-tools

# 스크립트 실행
gptscript my-script.gpt

# 채팅형으로 강제 실행
gptscript --force-chat my-script.gpt

더 알아보기