pi-agent
Ajuda seu agente a construir e operar um ambiente de codificação chamado Pi. Permite configurar ferramentas, criar extensões e integrar modelos de linguagem.
O que ela faz
Pi Agent é uma ferramenta para ajudar você a usar e a criar com o Pi, um sistema para programar no seu terminal. Ele permite instalar, configurar e usar o Pi para diversas tarefas de programação.
Quando usar
- ✓Quando você quer instalar ou configurar o Pi.
- ✓Ao criar novas extensões ou ferramentas para o Pi.
- ✓Para integrar o Pi com outros programas ou sistemas.
Exemplo do que pedir para a IA
“Como eu instalo o Pi e configuro meu primeiro provedor?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
O Pi Agent entende suas instruções para gerenciar o Pi. Ele pode instalar o Pi, ajustar configurações, criar novas funcionalidades ou conectar o Pi a outros sistemas usando diferentes métodos de comunicação.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add K-Dense-AI/scientific-agent-skills --skill pi-agentOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/main/skills/pi-agent/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Agente Pi
Use esta habilidade quando o usuário quiser operar o Pi ou construir sobre ele. Pi é um ambiente mínimo de codificação de terminal estendido através de extensões TypeScript, habilidades, modelos de prompt, temas, pacotes, modelos/provedores personalizados, integrações de SDK, modo RPC, fluxos de eventos JSON e componentes TUI.
Primeira Decisão
Escolha a referência antes de responder ou codificar:
| Intenção do usuário | Ler |
|---|---|
| O que é Pi, mapa de documentação, métodos de instalação | references/overview.md |
| Instalação, autenticação, primeira execução | references/quickstart.md |
| Uso diário da CLI, comandos, modos, flags, confiança do projeto | references/usage.md |
| Autenticação de provedor, chaves de API, configuração de provedor de nuvem | references/providers.md |
| Entradas de modelo personalizadas, modelos locais, proxies, flags de compatibilidade | references/models.md |
Roteador local llama.cpp, /llama, download/carregamento de modelo |
references/llama-cpp.md |
| Chaves e padrões de configurações | references/settings.md |
PI_* e outras variáveis de ambiente |
references/environment-variables.md |
| Desenvolvimento de extensões, ferramentas personalizadas, eventos, comandos | references/extensions.md |
| Implementação de provedor personalizado, OAuth, streaming personalizado | references/custom-provider.md |
| Incorporar Pi em Node/TypeScript | references/sdk.md |
| Integrar de outro processo/linguagem | references/rpc.md |
| Consumir saída de eventos JSONL | references/json.md |
| Construir componentes de interface de usuário de terminal | references/tui.md |
| Empacotar extensões/habilidades/prompts/temas | references/packages.md |
| Delegar para subagentes, cadeias, execuções paralelas, orquestração | references/pi-subagents.md |
| Conectar servidores MCP, codemode, descoberta/configuração de ferramentas MCP | references/mcp.md (integrado), references/pi-mcp-adapter.md (adaptador opcional) |
| Formulários de entrevista interativos, entrada estruturada do usuário | references/pi-interview.md |
| Pesquisa na web, busca de URL/PDF/repositório, compreensão de vídeo | references/pi-web-access.md |
| Criar habilidades Pi | references/skills.md |
| Modelos de prompt ou temas | references/prompt-templates.md, references/themes.md |
| Sessões, ramificações, compactação, análise de JSONL | references/sessions.md, references/compaction.md, references/session-format.md |
| Segurança, sandboxing, confiança | references/security.md, references/containerization.md |
| Problemas de teclado ou terminal | references/keybindings.md, references/terminal-setup.md, references/tmux.md, references/windows.md, references/termux.md, references/shell-aliases.md |
| Trabalhando no próprio Pi | references/development.md |
Padrões Build-On-Pi
Prefira o SDK para aplicativos Node/TypeScript que precisam de segurança de tipo, acesso direto ao estado, ferramentas/extensões personalizadas no processo ou carregamento de recursos personalizados. Use createAgentSession() para uma única sessão estável; use createAgentSessionRuntime() quando o aplicativo precisar substituir sessões através de fluxos de novo/retomar/fork/clone/importar. A autenticação e a busca de modelos passam por ModelRuntime.create().
Prefira o modo RPC quando o cliente não for Node.js, precisar de isolamento de processo ou quiser um protocolo JSONL agnóstico de linguagem. Comece com pi --mode rpc --no-session para integração de subprocesso sem estado, depois adicione flags de sessão quando a persistência for importante. Divida os registros apenas em \n — o Node readline não é compatível com o protocolo.
Para clientes RPC, correlacione respostas por id de solicitação exclusivo, não por ordem de chegada,
e continue consumindo eventos após uma resposta prompt bem-sucedida. Sucesso significa
aceito, enfileirado ou tratado; não é conclusão. Assine antes de enviar o prompt e aguarde agent_settled para execuções que realmente começam, porque
agent_end pode preceder retentativas ou trabalho enfileirado. Se a resposta relatar
disposition: "handled", nenhuma execução começou e nenhum evento resolvido é devido. Veja o
ciclo de vida RPC upstream.
Prefira o modo JSON para pipelines de linha de comando de uso único que precisam apenas de eventos transmitidos, não de controle bidirecional: pi --mode json "prompt".
Use extensões para comportamento nativo do Pi: ferramentas personalizadas, manipuladores de comandos, ganchos de eventos, registro de provedores, compactação personalizada, proteção de caminhos, política de confiança de projeto, prompts de UI, widgets e componentes TUI.
Use pacotes ao compartilhar ou instalar extensões, habilidades, modelos de prompt ou temas reutilizáveis entre máquinas ou projetos.
Padrões de Segurança
…
Perguntas frequentes
O que é o Pi?
Pi é um sistema para programar diretamente no seu terminal, que pode ser estendido com novas funcionalidades.
O que são 'providers'?
Providers são como conexões que o Pi usa para interagir com diferentes modelos de linguagem ou serviços, como chaves de API.
O que significa 'RPC' ou 'JSON event streams'?
São formas técnicas de fazer o Pi se comunicar com outros programas, enviando e recebendo informações em formatos específicos.
Detalhes
Descrição original do autor
Builds with and operates Pi, the minimal terminal coding harness. Use for installing Pi, configuring providers/models/settings/environment variables, creating Pi skills/extensions/packages/themes/prompt templates, embedding Pi through the SDK, integrating over RPC or JSON event streams, parsing sessions, running local models through the llama.cpp router, developing custom Pi providers and TUI comp
Popularidade
- Estrelas no GitHub
- 51 mil
- Posição no ranking
- #1935
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
13c-metabolic-flux
Estima fluxos metabólicos usando dados de rastreamento de isótopos de carbono-13. É útil para analisar o metabolismo celular e vias bioquímicas.
K-Dense-AI/scientific-agent-skills
adaptyv
Projeta experimentos de caracterização de proteínas usando a API Adaptyv. Ele ajuda a estimar custos, enviar sequências e monitorar resultados de laboratório.
K-Dense-AI/scientific-agent-skills
aeon
Realiza tarefas de aprendizado de máquina em séries temporais. É útil para classificar, prever, detectar anomalias e encontrar padrões em dados sequenciais.
K-Dense-AI/scientific-agent-skills
alphagenome
Consulta efeitos genômicos pré-calculados para variantes genéticas. Ele fornece pontuações e explicações para entender o impacto das variantes no genoma.
K-Dense-AI/scientific-agent-skills
Skills parecidas
benchmark-optimization-loop
Faz seu agente melhorar a velocidade de algo de forma medida. Ele testa várias versões e escolhe a mais rápida que ainda funciona corretamente.
affaan-m/ECC
change-impact
Ajuda seu agente a analisar o impacto de mudanças no código antes de fazê-las. Ele compara o planejado com o real depois, cobrindo caminhos, dados, testes e documentação. É útil para mudanças arriscadas ou que afetam várias partes do sistema.
affaan-m/ECC
click-path-audit
Faz seu agente rastrear todos os botões e interações do usuário para achar bugs. Ele encontra problemas onde funções parecem funcionar sozinhas, mas falham juntas. Útil quando bugs persistem mesmo após depuração.
affaan-m/ECC