Repolode
potpie-ai

potpie-ai/potpie

Un grafo de contexto con una CLI que indexa tu base de código, incidencias y conocimiento del equipo para que los agentes de programación con IA trabajen con contexto específico del proyecto.

Estrellas
5,748
Forks
686
Issues abiertos
113
Último commit
hace 7 horas

¿Qué es?

Potpie crea un grafo de contexto dinámico a partir de una base de código y de su ciclo de vida de desarrollo de software. Abarca la estructura del código, las decisiones, el historial de cambios, el conocimiento del equipo y los flujos de trabajo de ingeniería. Los agentes de programación pueden consultar este grafo para responder preguntas, planificar cambios, depurar fallos y escribir código que encaje con el proyecto.

El proyecto prioriza la CLI y está diseñado tanto para personas como para agentes. Un asistente de configuración prepara la configuración local, el almacenamiento, un daemon, un espacio de trabajo predeterminado (llamado pot) y las skills para agentes. Comandos como resolve y search recuperan el contexto relevante antes de una tarea, mientras que record guarda aprendizajes duraderos del proyecto. Una interfaz web local ofrece un explorador del grafo.

Las integraciones actuales incluyen GitHub, Linear, Jira y Confluence. Los entornos de programación compatibles son Claude Code, OpenAI Codex, Cursor y OpenCode. El proyecto se distribuye en PyPI y cuenta con licencia Apache 2.0.

Funciones clave

  • 01Indexa la estructura del código, las pull requests, las incidencias y el historial de cambios en un único grafo de contexto.
  • 02Ofrece los comandos resolve y search para recuperar el contexto relevante para cada tarea.
  • 03Permite que los agentes registren decisiones y aprendizajes duraderos del proyecto con el comando record.
  • 04Se conecta a fuentes de GitHub, Linear, Jira y Confluence.
  • 05Instala skills para agentes de Claude Code, Codex, Cursor y OpenCode.

Casos de uso

  • Proporcionar a un agente de programación información del proyecto antes de que planifique o modifique código en un repositorio que no conoce.
  • Localizar dónde se implementa un flujo de autenticación, un error o una convención en una base de código.
  • Registrar decisiones de arquitectura para que futuras sesiones con agentes puedan consultarlas.
  • Depurar fallos relacionando el historial del código con las incidencias y los documentos pertinentes.

Inicio rápido

  1. 1

    Instala Potpie CLI desde PyPI con uv

    uv tool install potpie
  2. 2

    Ejecuta el asistente de configuración de Potpie

    potpie setup
  3. 3

    Abre tu entorno de programación configurado y pídele que use Potpie para el repositorio

Antes de usarlo

  • Es necesario iniciar sesión en Potpie para usar las funciones vinculadas a la cuenta y las funciones gestionadas.
  • Para conectar integraciones como GitHub, Linear, Jira y Confluence, se necesitan credenciales independientes.

Temas

Preguntas frecuentes

¿Qué es potpie?
Un grafo de contexto con una CLI que indexa tu base de código, incidencias y conocimiento del equipo para que los agentes de programación con IA trabajen con contexto específico del proyecto. Potpie crea un grafo de contexto dinámico a partir de una base de código y de su ciclo de vida de desarrollo de software. Abarca la estructura del código, las decisiones, el historial de cambios, el conocimiento del equipo y los flujos de trabajo de ingeniería. Los agentes de programación pueden consultar este grafo para responder preguntas, planificar cambios, depurar fallos y escribir código que encaje con el proyecto.
¿potpie es gratuito? ¿Qué licencia tiene?
potpie es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿potpie sigue mantenido?
Mantenimiento activo. El último commit de potpie fue el 22 oct 2026.
¿Para qué puedo usar potpie?
Proporcionar a un agente de programación información del proyecto antes de que planifique o modifique código en un repositorio que no conoce. Localizar dónde se implementa un flujo de autenticación, un error o una convención en una base de código. Registrar decisiones de arquitectura para que futuras sesiones con agentes puedan consultarlas. Depurar fallos relacionando el historial del código con las incidencias y los documentos pertinentes.
¿Cómo se instala potpie?
Instala Potpie CLI desde PyPI con uv: uv tool install potpie Ejecuta el asistente de configuración de Potpie: potpie setup Abre tu entorno de programación configurado y pídele que use Potpie para el repositorio
¿Dónde consigo potpie?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/potpie-ai/potpie

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados