Apache Magpie Documentation

Apache Magpie is an AI assistant for open-source project maintainers. It handles the repetitive parts of running a project — triaging issues, reviewing PRs, onboarding contributors, managing security reports, cutting releases — so maintainers can spend their time on the work that needs a human. The agent proposes; the human decides.

Quick Start

Adopt Magpie in your repo with a single copy-pasteable bootstrap, then let the setup skill wire up the rest. Pick an install method and follow the verbatim recipe:

⚡ Quick Start → Install recipes · Prerequisites · What is Apache Magpie? · Architecture

Explore the docs

109 pages, synced from apache/magpie/docs and grouped by area. Every page is also in the sidebar.

Overview & concepts

What Magpie is, how it works, and the cross-cutting concepts — modes, design principles, confidentiality, labels, and editorial guidelines.

Education

The maintainer-education stream — a step-by-step path to building and running agents for your project: what agents are, working with them, writing and evaluating your first skill, English as code, and contributing back, plus a pattern catalogue and hands-on tutorials.

Setup

Adopt Magpie in your repo and run agents safely — install recipes, prerequisites, sandboxing, privacy/LLM routing, and unadopting.

PR management

Maintainer-facing PR-queue triage, stats, and deep code review.

    Issue management

    Issue triage, bug reproduction, fix drafting, and backlog re-assessment.

      Mentoring

      Contributor mentoring — the spec, tone guide, and first skills.

      Contributor growth

      The contributor-to-committer path — welcoming, activity tracking, and nomination evidence.

        Repo health

        Read-only maintenance audits — CI, dependencies, licenses, and flaky tests.

          Pairing

          Developer-side skills you run in your own dev loop.

            Release management

            The ASF release lifecycle — plan, cut, vote, promote, announce.

            Security

            The security-issue lifecycle — process, roles, forwarder routing policy, onboarding, and the threat model. Maintainer-only.

            Utilities

            Framework meta-skills — author skills and list every skill.

              Adapters

              Authoring adapters and the discovery registry of in-tree and external backends.

              Tools

              Every framework tool — the contract or substrate it provides, with per-tool docs.

              RFCs

              Design proposals under discussion.

              Skill Sources

              Suggest a change