Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Introduction

Apira is a semantic search API for GitHub repositories, built for AI agents and the teams that build them, allowing agents to find relevant repositories by describing the implementation they need. When a task is complex, unfamiliar, or blocked, agents can use Apira to find working open-source implementations, compare approaches, and avoid reinventing patterns that already exist.

Approach

Apira is built on the belief that agents produce better implementation work when they are grounded in relevant, working examples. Instead of reinventing patterns that already exist, agents can use Apira to find open-source repositories that provide concrete context for design, dependency, and coding decisions.

For complex patterns that are already open source, a better workflow is often:

  1. Find projects that solved a similar problem.
  2. Study how they work.
  3. Reuse or adapt the parts that fit.
  4. Improve on them for your own use case.

Apira gives agents a repository-discovery tool for that workflow. To set it up in a coding agent, start with Apira for Coding Agents.

When agents should use Apira

Use Apira when an agent needs to:

  • Get unblocked on a complex implementation detail.
  • Find maintained libraries for a task.
  • Discover implementation patterns before building.
  • Compare alternatives in an ecosystem.
  • Find architecture examples.
  • Ground a plan in open-source evidence before recommending an approach.

Apira is not a code-search replacement and it is not a license or security review tool. It helps an agent choose which repositories are worth inspecting next.

What Apira searches

The public API currently supports semantic search for GitHub repositories through POST /v1/github/search.

For exact endpoint schemas, use the interactive API reference or the OpenAPI JSON. Agents can also start from /llms.txt for machine-oriented integration notes. For companion skill/workflow templates, see Follow-on Skills.