# Pi Agent Client

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

등록 대상:

```text
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
```

## 설치

```bash
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 원문은 이 폴더에 포함하지 않는다.
