Configuração, personalização, ajustes de plataforma e referências de API para Pi.

Desenvolvimento

Consulte AGENTS.md para orientações adicionais.

Configurar

git clone https://github.com/earendil-works/pi-mono
cd pi-mono
npm install
npm run build

Execute a partir da fonte:

/path/to/pi-mono/pi-test.sh

O script pode ser executado em qualquer diretório. Pi mantém o diretório de trabalho atual do chamador.

Bifurcação / Rebranding

Configurar via package.json:

{
  "piConfig": {
    "name": "pi",
    "configDir": ".pi"
  }
}

Altere os campos name, configDir e bin para seu fork. Afeta o banner CLI, caminhos de configuração e nomes de variáveis ​​de ambiente.

Resolução de caminho

Três modos de execução: npm instalação, binário independente, tsx da fonte.

Sempre use src/config.ts para ativos de pacote:

import { getPackageDir, getThemeDir } from "./config.js";

Nunca use __dirname diretamente para ativos de pacote.

Comando de depuração

/debug (oculto) escreve em ~/.pi/agent/pi-debug.log:

  • Linhas TUI renderizadas com códigos ANSI
  • Últimas mensagens enviadas para o LLM

Teste

./test.sh                         # Run non-LLM tests (no API keys needed)
npm test                          # Run all tests
npm test -- test/specific.test.ts # Run specific test

Estrutura do Projeto

packages/
  ai/           # LLM provider abstraction
  agent/        # Agent loop and message types  
  tui/          # Terminal UI components
  coding-agent/ # CLI and interactive mode