Repolode
potpie-ai

potpie-ai/potpie

코드베이스, 이슈, 팀 지식을 색인하는 CLI 기반 컨텍스트 그래프로, AI 코딩 에이전트가 프로젝트에 맞는 맥락을 활용하도록 지원합니다.

스타
5,748
포크
686
열린 이슈
113
마지막 커밋
7시간 전

어떤 프로젝트인가요?

Potpie는 코드 구조, 의사결정, 소스 이력, 팀 지식, 엔지니어링 워크플로를 아우르는 코드베이스와 소프트웨어 개발 수명 주기의 살아 있는 컨텍스트 그래프를 구축합니다. 코딩 에이전트는 이 그래프를 조회해 질문에 답하고, 변경을 계획하고, 오류를 디버깅하며, 프로젝트에 맞는 코드를 작성할 수 있습니다.

이 프로젝트는 CLI를 우선하며 사람과 에이전트 모두를 위해 설계되었습니다. 설정 마법사는 로컬 설정, 저장소, 데몬, 기본 작업 공간(‘pot’이라고 함), 에이전트 스킬을 구성합니다. resolve 및 search 같은 명령으로 작업을 시작하기 전에 관련 맥락을 가져오고, record 명령으로 프로젝트의 유용한 지식을 지속적으로 저장할 수 있습니다. 로컬 웹 UI에서는 그래프를 탐색할 수 있습니다.

현재 GitHub, Linear, Jira, Confluence와 연동됩니다. 지원하는 코딩 하네스는 Claude Code, OpenAI Codex, Cursor, OpenCode입니다. PyPI를 통해 배포되며 Apache 2.0 라이선스를 따릅니다.

핵심 기능

  • 01코드 구조, pull request, 이슈, 소스 이력을 하나의 컨텍스트 그래프로 색인합니다.
  • 02resolve 및 search 명령으로 에이전트가 작업에 필요한 맥락을 가져올 수 있습니다.
  • 03record 명령으로 에이전트가 프로젝트의 의사결정과 유용한 지식을 지속적으로 저장할 수 있습니다.
  • 04GitHub, Linear, Jira, Confluence 소스와 연결됩니다.
  • 05Claude Code, Codex, Cursor, OpenCode용 에이전트 스킬을 설치합니다.

활용 사례

  • 익숙하지 않은 저장소에서 코드를 계획하거나 수정하기 전에 코딩 에이전트에 프로젝트 배경 정보를 제공합니다.
  • 코드베이스에서 인증 흐름, 버그, 규칙이 있는 위치를 찾습니다.
  • 아키텍처 결정을 기록해 이후 에이전트 세션에서 참조할 수 있도록 합니다.
  • 코드 이력을 관련 이슈 및 문서와 연결해 오류를 디버깅합니다.

빠른 시작

  1. 1

    uv를 사용해 PyPI에서 Potpie CLI를 설치합니다

    uv tool install potpie
  2. 2

    Potpie 설정 마법사를 실행합니다

    potpie setup
  3. 3

    설정된 코딩 하네스를 열고 저장소에서 Potpie를 사용하도록 요청합니다

사용 전 알아둘 점

  • 계정 기반 기능과 관리형 기능을 사용하려면 Potpie에 로그인해야 합니다.
  • GitHub, Linear, Jira, Confluence 등의 통합을 연결하려면 별도의 인증 정보가 필요합니다.

토픽

자주 묻는 질문

potpie은(는) 무엇인가요?
코드베이스, 이슈, 팀 지식을 색인하는 CLI 기반 컨텍스트 그래프로, AI 코딩 에이전트가 프로젝트에 맞는 맥락을 활용하도록 지원합니다. Potpie는 코드 구조, 의사결정, 소스 이력, 팀 지식, 엔지니어링 워크플로를 아우르는 코드베이스와 소프트웨어 개발 수명 주기의 살아 있는 컨텍스트 그래프를 구축합니다. 코딩 에이전트는 이 그래프를 조회해 질문에 답하고, 변경을 계획하고, 오류를 디버깅하며, 프로젝트에 맞는 코드를 작성할 수 있습니다.
potpie은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
potpie은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
potpie은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. potpie의 마지막 커밋은 2026년 10월 22일입니다.
potpie은(는) 어디에 사용할 수 있나요?
익숙하지 않은 저장소에서 코드를 계획하거나 수정하기 전에 코딩 에이전트에 프로젝트 배경 정보를 제공합니다. 코드베이스에서 인증 흐름, 버그, 규칙이 있는 위치를 찾습니다. 아키텍처 결정을 기록해 이후 에이전트 세션에서 참조할 수 있도록 합니다. 코드 이력을 관련 이슈 및 문서와 연결해 오류를 디버깅합니다.
potpie는 어떻게 설치하나요?
uv를 사용해 PyPI에서 Potpie CLI를 설치합니다: uv tool install potpie Potpie 설정 마법사를 실행합니다: potpie setup 설정된 코딩 하네스를 열고 저장소에서 Potpie를 사용하도록 요청합니다
potpie은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/potpie-ai/potpie

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트