pi 에이전트를 위한 터미널 사용자 인터페이스 (TUI) 프론트엔드

demo.web.mp4

Bubble Tea로 구축된 pi 에이전트를 위한 세련된 터미널 사용자 인터페이스(TUI) 프론트엔드입니다. pi --mode rpc는 백엔드(다중 프로바이더, 도구, 세션, 압축) 역할을 하며, pitago는 JSONL을 통해 통신하는 풍부한 터미널 인터페이스를 제공합니다.

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/cavaldos/pitago/main/script/install.sh | bash
# Windows (PowerShell)
...

소스 코드로부터 빌드:

git clone https://github.com/cavaldos/pitago.git
cd pitago
script/build.sh # bin/pitago를 출력합니다 (버전은 git tag/commit을 기본으로 합니다)
...

go run ./src # 이 디렉토리에서 시작합니다
go run ./src ~/Code/workspace # 또는 다른 디렉토리를 엽니다 (플래그 우선)
go run ./src -c # 가장 최근 세션을 재개합니다
...

/를 입력하여 명령어 팝업을 열 수 있습니다. 내장 명령어는 로컬에서 가로채져 RPC를 통해 재구현되며, 확장/프롬프트/스킬 명령어는 pi의 get_commands로부터 오며 서버 측에서 실행됩니다.

!를 입력하면 빈 입력창에서 편집기를 로컬 셸(local shell)로 전환합니다: Enter가 해당 라인을 실행하고, Esc는 모드를 벗어나 프로세스를 종료합니다. 셸 모드에서 입력된 내용은 절대로 pi에 도달하지 않습니다 — 어떤 턴이나 세션 기록으로도 남지 않으며 — 따라서 명령어는 모델의 것이 아니라 사용자의 것입니다. (!cmd를 입력해도 변경 없이 pi로 전송됩니다.)

세션의 현재 작업 디렉터리(cwd)를 사용하여 모든 라인마다 오래 유지되는 셸이 실행되므로, cd, export 및 셸 변수는 명령어 사이에 지속됩니다. 프로그램은 $SHELL입니다 (설정 /settings → Pitago → 셸 바이너리에서 재정의: $SHELL 또는 절대 경로). 명령어는 한 번에 하나씩 실행되며, Ctrl+C는 실행 중인 명령을 중단하는 대신 라인을 지웁니다 — 명령어는 완료될 때까지 계속 진행됩니다. 블록은 명령어 출력의 처음 2000바이트를 유지합니다 (pi가 자체 !cmd에 사용하는 예산이며, 전사(transcript)가 표시하는 것보다 훨씬 많으므로), 따라서 한 번 말이 많은 명령어 때문에 나중에 타이핑 속도가 느려지는 것을 방지할 수 있습니다.

pi의 자체 !cmd 이스케이프 (명령어당 새로운 프로세스, 출력은 모델에 보임)는 영향을 받지 않습니다.

go vet ./... # vet
go build -o /tmp/pitago ./src # build
go test ./... # test
...

A 태그는 크로스 빌드(linux-amd64, darwin-amd64/arm64, windows-amd64)를 수행하고 GitHub 릴리스에 게시합니다: script/release.sh v0.0.1.

.app은 얇은 MVC 셸이며, components는 순수한 뷰 프리미티브를 담고 있고, ext와 pitago는 별도의 순수 도메인 계층이며, builtin은 RPC 위의 명령어 표면(command surface)이고, pirpc/update는 백엔드 에지입니다. script/check-layers.sh`가 단방향 임포트 그래프를 강제합니다.