# Potpie

## Docs

- [API Access](https://docs.potpie.ai/agents/api-access.md): Use the Potpie API to parse repositories, create conversations, and query your codebase programmatically.
- [Code Generation Agent](https://docs.potpie.ai/agents/code-changes-agent.md)
- [Debugging Agent](https://docs.potpie.ai/agents/debugging-agent.md)
- [Codebase Q&A Agent](https://docs.potpie.ai/agents/qna-agent.md)
- [Tools Reference](https://docs.potpie.ai/agents/tools-reference.md)
- [Create Conversation](https://docs.potpie.ai/api-reference/endpoint/create-conversation.md): Create a new conversation with AI agents. Conversations maintain context across multiple messages and allow for interactive discussions about your codebase.
- [Create Conversation And Message](https://docs.potpie.ai/api-reference/endpoint/create-conversation-and-message.md): Convenience endpoint that creates a new conversation and sends a message in a single request. Perfect for one-off queries or integrating Potpie into external tools.
- [Get Parsing Status](https://docs.potpie.ai/api-reference/endpoint/get-parsing-status.md): Check the parsing status of a specific project using its project ID. Returns the current status and whether the parsed commit matches the latest commit on the branch.
- [List Available Agents](https://docs.potpie.ai/api-reference/endpoint/list-agents.md): Get a list of all available AI agents using API key authentication
- [List Projects](https://docs.potpie.ai/api-reference/endpoint/list-projects.md): Get a list of all projects using API key authentication
- [Parse Directory](https://docs.potpie.ai/api-reference/endpoint/parse-directory.md): Initiate parsing of a repository or directory to build Potpie's knowledge graph. This analyzes your codebase structure, relationships, and creates the foundational data that enables AI agents to understand and work with your code.
- [Post Message](https://docs.potpie.ai/api-reference/endpoint/post-message.md): Send a message to an existing conversation. The AI agent will respond based on the conversation context and your codebase knowledge graph.
- [Save Integration](https://docs.potpie.ai/api-reference/endpoint/save-integration.md): Save a new integration configuration for third-party services like Sentry, Jira, Linear, etc.
- [API Overview](https://docs.potpie.ai/api-reference/overview.md)
- [Ask](https://docs.potpie.ai/build-flow/ask-a-question.md): **Potpie's Q&A interface**
- [Build a Feature](https://docs.potpie.ai/build-flow/build-a-feature.md): **Potpie's code generation interface**
- [Debug](https://docs.potpie.ai/build-flow/debug-an-issue.md): **Potpie's bug investigation interface**
- [Forge](https://docs.potpie.ai/build-flow/forge.md)
- [Overview](https://docs.potpie.ai/build-flow/overview.md)
- [Recipe](https://docs.potpie.ai/build-flow/recipe.md)
- [Specialists](https://docs.potpie.ai/build-flow/specialists.md)
- [Trace](https://docs.potpie.ai/build-flow/trace.md)
- [Inference](https://docs.potpie.ai/concepts/inference.md): Inference in Potpie is the process of interpreting parsed code to understand what each symbol does and how it behaves in the system.
- [Knowledge Graph](https://docs.potpie.ai/concepts/knowledge-graph.md)
- [Parsing](https://docs.potpie.ai/concepts/parsing.md): With Potpie, you can with ease, parse through repository’s complex source code, build a structured dependency graph & seamlessly capture every symbol along with their relationship.
- [Custom Agents](https://docs.potpie.ai/custom-agents/introduction.md): Build an agent with a defined role, goal, and task set that runs against your codebase.
- [API Endpoint](https://docs.potpie.ai/examples/api-endpoint.md): Add a new endpoint with full dependency awareness and matching code style.
- [Auth Flow](https://docs.potpie.ai/examples/auth-flow.md): Understand how authentication works before building a protected endpoint.
- [Auth Middleware](https://docs.potpie.ai/examples/auth-middleware.md): Update authentication middleware consistently across every protected route.
- [Code Migration](https://docs.potpie.ai/examples/code-migration.md): Migrate a module to a new pattern with full dependency awareness.
- [Code Review](https://docs.potpie.ai/examples/code-review.md): Understand exactly what a PR changes across the full codebase before approving it.
- [Impact Analysis](https://docs.potpie.ai/examples/impact-analysis.md): Find everything that depends on a service before you change it.
- [Memory Leak](https://docs.potpie.ai/examples/memory-leak.md): Trace a memory leak in a long running service to its source across object lifecycle and dependency chains.
- [Null Pointer](https://docs.potpie.ai/examples/null-pointer.md): Trace a null pointer exception to its origin across service and data layers.
- [Example Uses](https://docs.potpie.ai/examples/overview.md): Real tasks across Ask, Build, and Debug , each grounded in your actual codebase.
- [Race Conditions](https://docs.potpie.ai/examples/race-conditions.md): Trace and fix race conditions causing intermittent failures in production.
- [Rate Limiting](https://docs.potpie.ai/examples/rate-limiting.md): Add rate limiting to existing routes with full middleware chain awareness.
- [Refactor Scope](https://docs.potpie.ai/examples/refactor-scope.md): Map every dependency before touching a shared service.
- [Potpie](https://docs.potpie.ai/introduction.md): Spec-driven development for enterprise codebases
- [Spec Agent](https://docs.potpie.ai/pre-built-agents/specgen-agent.md)
- [Quickstart](https://docs.potpie.ai/quickstart.md): Start using Potpie for your codebase in four steps.
- [Local Setup](https://docs.potpie.ai/self-hosting/setup.md): Run Potpie locally on your own infrastructure.
- [Configure Custom Agents](https://docs.potpie.ai/tutorials/configure-custom-agents.md)
- [Explore Your Codebase](https://docs.potpie.ai/tutorials/explore-your-codebase.md)
- [Generate an API Key](https://docs.potpie.ai/tutorials/generate-api-key.md)
- [Make Code Changes](https://docs.potpie.ai/tutorials/make-code-changes.md)
- [Trace and Fix Bugs](https://docs.potpie.ai/tutorials/trace-and-fix.md)

## OpenAPI Specs

- [openapi](https://docs.potpie.ai/api-reference/openapi.yaml)