junghan0611/pi-shell-acp

O que pi-shell-acp faz?

Provedor de ponte ACP para pi — use Claude Code, Codex e Gemini via ACP oficial com persistência de sessão e orquestração MCP/entwurf.

Visão Geral

O pi-shell-acp fornece uma ponte ACP para a ferramenta pi, permitindo que desenvolvedores interajam com agentes de IA como Claude Code, Codex (da OpenAI) e Gemini (do Google) usando um protocolo padrão. Ele suporta persistência de sessão (contexto entre conversas) e orquestração via MCP e entwurf (esboço de arquitetura).

Funcionalidades

• Ponte ACP: Comunicação padronizada com agentes usando o Agent Communication Protocol.
• Múltiplos provedores: Claude Code, Codex e Gemini — troque entre eles facilmente.
• Persistência de sessão: Mantém contexto e histórico entre sessões do pi.
• Orquestração MCP/entwurf: Use protocolos de contexto de modelo e esboço para fluxos multiagente.
• Interface de terminal: Funciona diretamente no shell, sem dependências de GUI.

Pré-requisitos

• Node.js (v18 ou superior)
• npm
• A ferramenta pi instalada (veja pi)
• Chaves de API para os provedores desejados (Claude, Codex, Gemini)

Instalação

npm install -g pi-shell-acp

Ou clone o repositório e instale localmente:

git clone https://github.com/junghan0611/pi-shell-acp.git
cd pi-shell-acp
npm install
npm link

Configuração

Defina as seguintes variáveis de ambiente no seu arquivo ~/.bashrc ou ~/.zshrc:

export ANTHROPIC_API_KEY="sua-chave-claude"
export OPENAI_API_KEY="sua-chave-codex"
export GEMINI_API_KEY="sua-chave-gemini"

Configure o provedor padrão no pi:

pi config set provider acp
pi config set acp-bridge pi-shell-acp

Uso

Inicie o pi com o provedor ACP:

pi --provider acp

Selecione um provedor de IA durante a sessão:

pi> /provider claude-codex
pi> /provider gemini
pi> /provider codex

Comandos disponíveis:

• /provider <nome> — alterna o provedor ativo
• /session — exibe informações da sessão atual
• /reset — reinicia a sessão (limpa contexto)
• /help — ajuda

Exemplo de sessão

$ pi --provider acp
pi> Qual é a capital da França?
A capital da França é Paris.
pi> /provider codex
pi> Traduza "Hello, world!" para português.
"Olá, mundo!"
pi> /session
Provedor atual: codex
ID da sessão: sessao-abc123
Contexto: 2 mensagens
pi>

Orquestração com MCP e entwurf

Para fluxos multiagente, ative a orquestração:

pi config set acp-mcp-enabled true
pi config set acp-entwurf-enabled true

Isso permite que o pi roteie subtarefas entre provedores (ex.: Claude para análise, Codex para geração de código) usando o protocolo MCP e a estrutura entwurf.

Solução de problemas

• Erro de conexão: Verifique se as chaves de API estão configuradas corretamente.
• Provedor não encontrado: Certifique-se de que o nome do provedor corresponde a um dos suportados.
• Persistência de sessão falhando: O diretório ~/.pi/sessions deve existir e ser gravável.

Licença

MIT

Contribuindo

Pull requests são bem-vindos. Para mudanças grandes, abra uma issue primeiro para discutir o que gostaria de alterar.

---

Documentação traduzida para português do original junghan0611/pi-shell-acp.