Repo brief: OpenFeign/feign

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T02:11:32.427Z · commit 22c3b4b0bdcf

Verdict

Healthy — Strong maintenance signals

• Last commit 1d ago
• 10 active contributors
• Distributed ownership (top contributor 31% of recent commits)
• Apache-2.0 licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

What it is

OpenFeign is a Java HTTP client library that reduces boilerplate by using annotations to declaratively bind Java interfaces to HTTP APIs. It processes annotations into templated HTTP requests, automatically handling encoding/decoding and error handling, making it dramatically simpler to write REST clients compared to raw HTTP libraries like Apache HttpClient or OkHttp. Multi-module Maven monorepo: core/ contains the primary feign-core library with annotation processing and client interfaces; annotation-error-decoder/ adds @ErrorHandling annotation support; apt-test-generator/ is an annotation processor for generating test stubs; codequality/ holds checkstyle rules; and top-level…

Start here

• core/src/main/java/feign/AsyncFeign.java: Entry point for async HTTP client construction; shows how Feign…
• [annotation-error-decoder/src/main/java/feign/error/AnnotationErrorDecoder.java](https://github.com/OpenFeign/feign/blob/master/annotation-error-decoder/src/main/java/feign/error/AnnotationErrorDecod…
• [apt-test-generator/src/main/java/feign/apttestgenerator/GenerateTestStubAPT.java](https://github.com/OpenFeign/feign/blob/master/apt-test-generator/src/main/java/feign/apttestgenerator/GenerateTestS…
• core/pom.xml: Core module dependencies and build config; establishes baseline for understanding integration points
• src/config/bom.xml: Bill of Materials for managing transitive dependency versions across all Feign modules

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/OpenFeign/feign.git
cd feign
mvn clean install

Use Maven (pom.xml present at root and all modules). Verify the exact version in parent pom before running; repository data shows 13.15-SNAPSHOT.

Daily commands:

This is a library, not an application with a runtime server. To verify the build: mvn clean verify (standard Maven). To use it in a project, add feign-core (and desired modules like annotation-error-decoder) to your p…

…shortened for this brief.

Key cautions & unknowns

• Java version matters: Feign 10.x+ require Java 8+; older versions (9.x) support JDK 6. The annotation processor (apt-test-generator) runs at compile-time and may require IDE configuration in IntelliJ/Eclipse to be…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.