CLI 채널

명령줄 인터페이스는 Triggerfish의 기본 채널입니다. 항상 사용 가능하며 외부 설정이 필요 없고, 개발 및 로컬 사용 시 에이전트와 상호 작용하는 주요 방법입니다.

분류

CLI 채널은 기본적으로 INTERNAL 분류입니다. 터미널 사용자는 항상 소유자로 취급됩니다 -- 프로세스를 직접 머신에서 실행하고 있기 때문에 페어링이나 인증 절차가 없습니다.

왜 INTERNAL인가? CLI는 직접적인 로컬 인터페이스입니다. 터미널에

접근할 수 있는 사람만 사용할 수 있습니다. 이로 인해 INTERNAL이 적절한 기본값입니다 -- 에이전트가 이 컨텍스트에서 내부 데이터를 자유롭게 공유할 수 있습니다. :::

기능

원시 터미널 입력

CLI는 전체 ANSI 이스케이프 시퀀스 파싱과 함께 원시 터미널 모드를 사용합니다. 이를 통해 터미널에서 직접 풍부한 편집 경험을 제공합니다:

• 줄 편집 -- 화살표 키, Home/End로 탐색, Ctrl+W로 단어 삭제
• 입력 히스토리 -- 위/아래 키로 이전 입력 순환
• 제안 -- 일반 명령에 대한 탭 완성
• 여러 줄 입력 -- 긴 프롬프트를 자연스럽게 입력

간결한 도구 표시

에이전트가 도구를 호출할 때 CLI는 기본적으로 간결한 한 줄 요약을 표시합니다:

tool_name arg  result

Ctrl+O로 간결한 표시와 확장된 도구 출력 간에 전환할 수 있습니다.

실행 중인 작업 중단

ESC를 눌러 현재 작업을 중단합니다. 이는 오케스트레이터를 통해 LLM 프로바이더에 중단 신호를 보내 즉시 생성을 중지합니다. 긴 응답이 끝날 때까지 기다릴 필요가 없습니다.

테인트 표시

CLI 채널 구성에서 showTaint를 활성화하여 출력에 현재 세션 테인트 레벨을 선택적으로 표시할 수 있습니다. 이는 각 응답 앞에 분류 등급을 추가합니다:

[CONFIDENTIAL] Here are your Q4 pipeline numbers...

컨텍스트 길이 진행 바

CLI는 터미널 하단의 구분선에 실시간 컨텍스트 윈도우 사용량 바를 표시합니다:

[████████████░░░░░░░░] 62% ctx  MCP 3/3

• 컨텍스트 토큰이 소비됨에 따라 바가 채워집니다
• 70% 임계값(자동 압축이 트리거되는 지점)에 파란색 마커가 나타납니다
• 한계에 가까워지면 바가 빨간색으로 변합니다
• 압축(/compact 또는 자동) 후 바가 리셋됩니다

MCP 서버 상태

구분선에는 MCP 서버 연결 상태도 표시됩니다:

표시	의미
MCP 3/3 (녹색)	구성된 모든 서버가 연결됨
MCP 2/3 (노란색)	일부 서버가 연결 중이거나 실패
MCP 0/3 (빨간색)	연결된 서버 없음

MCP 서버는 시작 후 백그라운드에서 느리게 연결됩니다. 서버가 온라인 상태가 되면 상태가 실시간으로 업데이트됩니다.

입력 히스토리

입력 히스토리는 세션 간에 다음 위치에 저장됩니다:

~/.triggerfish/data/input_history.json

히스토리는 시작 시 로드되고 각 입력 후 저장됩니다. 파일을 삭제하여 지울 수 있습니다.

Non-TTY / 파이프 입력

stdin이 TTY가 아닌 경우(예: 다른 프로세스에서 입력을 파이프하는 경우), CLI는 자동으로 줄 버퍼 모드로 전환됩니다. 이 모드에서:

• 원시 터미널 기능(화살표 키, 히스토리 탐색)이 비활성화됩니다
• 입력은 stdin에서 줄 단위로 읽습니다
• 출력은 ANSI 포맷 없이 stdout에 기록됩니다

이를 통해 에이전트와의 상호 작용을 스크립트할 수 있습니다:

echo "What is the weather today?" | triggerfish run

구성

CLI 채널은 최소한의 구성만 필요합니다. triggerfish run을 실행하거나 대화형 REPL을 사용할 때 자동으로 생성됩니다.

channels:
  cli:
    interactive: true
    showTaint: false

옵션	타입	기본값	설명
interactive	boolean	true	대화형 REPL 모드 활성화
showTaint	boolean	false	출력에 세션 테인트 레벨 표시

설정 불필요 CLI 채널은 바로 사용할 수 있습니다. 터미널에서

Triggerfish를 사용하기 위해 아무것도 구성할 필요가 없습니다. :::

키보드 단축키

단축키	동작
Enter	메시지 전송
위 / 아래	입력 히스토리 탐색
Ctrl+V	클립보드에서 이미지 붙여넣기 (멀티모달 콘텐츠로 전송)
Ctrl+O	간결/확장 도구 표시 전환
ESC	현재 작업 중단
Ctrl+C	CLI 종료
Ctrl+W	이전 단어 삭제
Home / End	줄의 시작/끝으로 이동