iop/agent-client/pi/README.md

Pi Agent Client

Pi Coding Agent에 Seulgivibe Codex/OpenAI 모델과 Claude 모델을 함께 등록한다.

등록 대상:

seulgivibe-codex/gpt-5.1:medium
seulgivibe-codex/gpt-5.5:xhigh
seulgivibe-claude/claude-sonnet-4-5
seulgivibe-claude/claude-opus-4-8
seulgivibe-claude/claude-fable-5

설치

cd agent-client/pi
./install.sh

설치 후 이미 실행 중인 Pi session은 /reload 하거나 재시작한다.

새 설정 파일을 만드는 환경에서는 기본 모델을 seulgivibe-codex/gpt-5.5로 둔다. 기존 기본값이 있으면 보존한다.

설치 스크립트는 OpenAI-compatible 요청에 temperature, top_p, repeat_penalty를 명시적으로 주입하지 않는다. sampling은 Pi와 대상 provider의 기본값을 따른다.

장시간 실행되는 local model이 Pi의 기본 5분 제한으로 중단되지 않도록 HTTP idle timeout을 비활성화하고 provider request timeout override를 제거한다.

credential-free 유지

이 설치기는 Seulgivibe Codex의 api: openai-responses 소비 경로를 변경하지 않는다. 기존에 Pi session에서 Responses API를 사용하던 환경이라면 설치 후에도 동일하게 동작한다. API key는 기존 ~/.pi/agent/models.json에 기록된 값을 보존하며, key가 없으면 ~/.claude/anthropic_key.sh에서 읽어 넣는다. 이 과정은 네트워크 접근이 필요하지 않으며, 사용자 home 디렉터리의 다른 파일을 변경하지 않는다.

전제

• Pi는 이미 설치되어 있어야 한다.
• 기존 ~/.pi/agent/settings.json, ~/.pi/agent/models.json의 개인 설정과 API key는 보존한다.
• 기존 ~/.pi/agent/settings.json에 extensions/openai-sampling-parameters.ts가 등록되어 있으면 제거한다.
• Seulgivibe key가 없으면 ~/.claude/anthropic_key.sh에서 읽어 넣는다.
• 기존 seulgivibe-openai 설정은 seulgivibe-codex로 이관한 뒤 제거한다.
• 기존 dev-corp 설정이 있으면 지우지 않고 보존한다.

JWT/API key 원문은 이 폴더에 포함하지 않는다.