Repolode
potpie-ai

potpie-ai/potpie

Um grafo de contexto controlado por CLI que indexa seu codebase, issues e conhecimento da equipe para dar aos agentes de programação com IA o contexto específico do projeto.

Estrelas
5,748
Forks
686
Issues abertas
113
Último commit
há 7 horas

O que é?

O Potpie cria um grafo de contexto dinâmico a partir do codebase e do ciclo de vida de desenvolvimento de software, abrangendo a estrutura do código, decisões, histórico do código-fonte, conhecimento da equipe e fluxos de trabalho de engenharia. Os agentes de programação podem consultar esse grafo para responder a perguntas, planejar mudanças, depurar falhas e escrever código adequado ao projeto.

O projeto prioriza a CLI e foi desenvolvido para pessoas e agentes. Um assistente de configuração prepara a configuração local, o armazenamento, um daemon, um workspace padrão (chamado de pot) e as skills dos agentes. Comandos como resolve e search buscam o contexto relevante antes de uma tarefa, enquanto record armazena aprendizados duradouros sobre o projeto. Uma interface web local oferece um explorador do grafo.

As integrações disponíveis atualmente incluem GitHub, Linear, Jira e Confluence. Os ambientes de programação compatíveis são Claude Code, OpenAI Codex, Cursor e OpenCode. O projeto é distribuído pelo PyPI e licenciado sob Apache 2.0.

Recursos principais

  • 01Indexa a estrutura do código, pull requests, issues e o histórico do código-fonte em um único grafo de contexto.
  • 02Oferece os comandos resolve e search para buscar o contexto relevante para a tarefa dos agentes.
  • 03Permite que agentes registrem decisões e aprendizados duradouros sobre o projeto com o comando record.
  • 04Conecta-se a fontes do GitHub, Linear, Jira e Confluence.
  • 05Instala skills para agentes no Claude Code, Codex, Cursor e OpenCode.

Casos de uso

  • Dar contexto sobre o projeto a um agente de programação antes que ele planeje ou edite código em um repositório desconhecido.
  • Encontrar onde estão um fluxo de autenticação, um bug ou uma convenção no codebase.
  • Registrar decisões de arquitetura para que sessões futuras com agentes possam consultá-las.
  • Depurar falhas relacionando o histórico do código a issues e documentos associados.

Início rápido

  1. 1

    Instale o Potpie CLI do PyPI com uv

    uv tool install potpie
  2. 2

    Execute o assistente de configuração do Potpie

    potpie setup
  3. 3

    Abra seu ambiente de programação configurado e peça para ele usar o Potpie no repositório

Antes de usar

  • É necessário entrar no Potpie para usar recursos vinculados à conta e recursos gerenciados.
  • Integrações como GitHub, Linear, Jira e Confluence precisam de credenciais separadas para se conectar.

Tópicos

Perguntas frequentes

O que é potpie?
Um grafo de contexto controlado por CLI que indexa seu codebase, issues e conhecimento da equipe para dar aos agentes de programação com IA o contexto específico do projeto. O Potpie cria um grafo de contexto dinâmico a partir do codebase e do ciclo de vida de desenvolvimento de software, abrangendo a estrutura do código, decisões, histórico do código-fonte, conhecimento da equipe e fluxos de trabalho de engenharia. Os agentes de programação podem consultar esse grafo para responder a perguntas, planejar mudanças, depurar falhas e escrever código adequado ao projeto.
potpie é gratuito? Qual é a licença?
potpie é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
potpie ainda é mantido?
Manutenção ativa. O último commit de potpie foi em 22 de out. de 2026.
Para que posso usar potpie?
Dar contexto sobre o projeto a um agente de programação antes que ele planeje ou edite código em um repositório desconhecido. Encontrar onde estão um fluxo de autenticação, um bug ou uma convenção no codebase. Registrar decisões de arquitetura para que sessões futuras com agentes possam consultá-las. Depurar falhas relacionando o histórico do código a issues e documentos associados.
Como instalar potpie?
Instale o Potpie CLI do PyPI com uv: uv tool install potpie Execute o assistente de configuração do Potpie: potpie setup Abra seu ambiente de programação configurado e peça para ele usar o Potpie no repositório
Onde consigo potpie?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/potpie-ai/potpie

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados