Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Aider website screenshot

Aider

Aider is an open-source, terminal-based AI pair programmer that edits code directly inside a developer's local Git repository. Written in Python and distributed via PyPI under the Apache 2.0 license, Aider is a BYO-LLM tool: the user supplies API keys for hosted models (Anthropic Claude, OpenAI, DeepSeek, Google Gemini, OpenRouter, Mistral, xAI, GROQ, Cohere, GitHub Copilot, Azure OpenAI, Amazon Bedrock, Vertex AI) or points it at local models running through Ollama, LM Studio, or any OpenAI-compatible endpoint. Distinguishing capabilities include a repository-wide codebase map that lets the model reason about files it has not been shown, multi-file architectural edits with diff-based patching, automatic Git commits with conventional commit messages, a lint/test/repair loop, image and URL context, voice-to-code, and an IDE bridge via `--watch-files` that picks up `AI!` / `AI?` comments written from any editor. Aider supports 100+ programming languages via tree-sitter, publishes a public LLM coding leaderboard (the polyglot benchmark across C++, Go, Java, JavaScript, Python, Rust), and has accumulated 45K+ GitHub stars with 4.5K+ forks. The product surface is a rich CLI (40+ in-chat slash commands across four chat modes: code, architect, ask, help) plus a Python module entrypoint (`python -m aider`); there is no hosted SaaS, no Aider-operated REST API, and no app-level rate-limiting or billing — all model inference is delegated to the user's chosen provider, and any pricing, rate limits, and FinOps surface live with that provider.

agent ready

Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.

Kin Score

API Evangelist profiles Aider the way a machine reads it — 101 machine-readable artifacts across 15 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Aider scores 47.9/100 (developing), with a separate agent-readiness read of 48/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 47.9/100 · developing
Contract Quality 17.0 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 0.0 / 20
Operational Transparency 6.8 / 13
Governance 10.4 / 12
Discoverability 9.3 / 10
Agent readiness — 48/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3

How we profile Aider

Each block below is one kind of artifact we hold for Aider. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 15

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

Individual APIs this provider publishes, each with its own machine-readable definition.

Aider Python Module

Aider exposes a Python module entrypoint (`python -m aider`) and an importable package (`aider.main.main`) so Aider can be embedded in Python scripts, CI workflows, and other ag...

Aider Chat API

Aider Commands That Manage the Chat Session and History.

Aider Editing API

Aider Commands That Drive Code Edits and Diffs.

Aider Files API

Aider Commands That Manage Files in the Chat Session.

Aider Git API

Aider Commands That Wrap Git Operations.

Aider IO API

Aider Commands That Move Data In and Out of the Session.

Aider Launch API

Aider Launch-Time Configuration via Flags, YAML, and Environment Variables.

Aider Map API

Aider Repository-Map Inspection.

Aider Models API

Aider Commands That Switch or Query LLM Models.

Aider Modes API

Aider Chat Modes (Code, Architect, Ask, Help, Context).

Aider Quality API

Aider Commands That Run Linters and Tests.

Aider Session API

Aider Session Lifecycle Commands.

Aider Settings API

Aider Settings, Tokens, and Reasoning Controls.

Aider Voice API

Aider Voice-to-Code Input.

Aider Web API

Aider Commands That Pull in Web Content.

Scroll within the panel for all 15 ·

Open Collections 1

Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Aider CLI

OPEN COLLECTION

Rate Limits 1

Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.

Documented rate limits and quota policies.

Aider Rate Limits

4 limits

RATE LIMITS

Semantic Vocabularies 1

JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.

JSON-LD contexts and semantic vocabularies used across these APIs.

Aider Cli Context

26 classes · 63 properties

JSON-LD

Spectral Rules 2

Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.

Aider API Rules

5 rules · 4 warnings

SPECTRAL

Aider API Rules

38 rules · 19 errors · 15 warnings

SPECTRAL

JSON Schema 26

Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.

Standalone JSON Schema definitions for this provider's data models.

AddFilesRequest

2 properties

JSON SCHEMA

AskRequest

1 properties

JSON SCHEMA

AskResponse

2 properties

JSON SCHEMA

ChatModeRequest

1 properties

JSON SCHEMA

CommitRequest

1 properties

JSON SCHEMA

CommitResult

2 properties

JSON SCHEMA

DiffResult

2 properties

JSON SCHEMA

DropFilesRequest

1 properties

JSON SCHEMA

EditRequest

3 properties

JSON SCHEMA

EditResult

5 properties

JSON SCHEMA

FileListing

2 properties

JSON SCHEMA

FilePathRequest

1 properties

JSON SCHEMA

LaunchConfig

22 properties

JSON SCHEMA

LintRequest

1 properties

JSON SCHEMA

ModelCatalog

1 properties

JSON SCHEMA

ModelSelection

1 properties

JSON SCHEMA

ReasoningEffortRequest

1 properties

JSON SCHEMA

RepositoryMap

2 properties

JSON SCHEMA

SettingsSnapshot

10 properties

JSON SCHEMA

ShellRequest

2 properties

JSON SCHEMA

ShellResult

3 properties

JSON SCHEMA

ThinkingTokensRequest

1 properties

JSON SCHEMA

TokenUsage

4 properties

JSON SCHEMA

VoiceTranscript

2 properties

JSON SCHEMA

WebFetchRequest

1 properties

JSON SCHEMA

WebFetchResult

2 properties

JSON SCHEMA

Scroll within the panel for all 26 ·

JSON Structure 26

JSON Structure captures the data shapes in a form built for tooling — a complement to JSON Schema that keeps the model machine-legible.

JSON Structure definitions describing this provider's data shapes.

Aider Cli Add Files Request Structure

2 properties

JSON STRUCTURE

Aider Cli Ask Request Structure

1 properties

JSON STRUCTURE

Aider Cli Ask Response Structure

2 properties

JSON STRUCTURE

Aider Cli Chat Mode Request Structure

1 properties

JSON STRUCTURE

Aider Cli Commit Request Structure

1 properties

JSON STRUCTURE

Aider Cli Commit Result Structure

2 properties

JSON STRUCTURE

Aider Cli Diff Result Structure

2 properties

JSON STRUCTURE

Aider Cli Drop Files Request Structure

1 properties

JSON STRUCTURE

Aider Cli Edit Request Structure

3 properties

JSON STRUCTURE

Aider Cli Edit Result Structure

5 properties

JSON STRUCTURE

Aider Cli File Listing Structure

2 properties

JSON STRUCTURE

Aider Cli File Path Request Structure

1 properties

JSON STRUCTURE

Aider Cli Launch Config Structure

22 properties

JSON STRUCTURE

Aider Cli Lint Request Structure

1 properties

JSON STRUCTURE

Aider Cli Model Catalog Structure

1 properties

JSON STRUCTURE

Aider Cli Model Selection Structure

1 properties

JSON STRUCTURE

Aider Cli Repository Map Structure

2 properties

JSON STRUCTURE

Aider Cli Settings Snapshot Structure

10 properties

JSON STRUCTURE

Aider Cli Shell Request Structure

2 properties

JSON STRUCTURE

Aider Cli Shell Result Structure

3 properties

JSON STRUCTURE

Aider Cli Token Usage Structure

4 properties

JSON STRUCTURE

Aider Cli Voice Transcript Structure

2 properties

JSON STRUCTURE

Aider Cli Web Fetch Request Structure

1 properties

JSON STRUCTURE

Aider Cli Web Fetch Result Structure

2 properties

JSON STRUCTURE

Scroll within the panel for all 26 ·

Examples 26

Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.

Example request and response payloads for these APIs.

Scroll within the panel for all 26 ·

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Aider Authentication

apiKey · 1 scheme

SECURITY

Aider Domain Security

TLSv1.3 · DNSSEC

SECURITY

Agentic Access 1

An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.

Recommended x-agentic-access execution contracts for AI agents.

Aider Agentic Access

40 operations · 32 acting · 1 human-in-the-loop

40 operations · 32 acting

AGENTIC

Resources

Every other property we hold for Aider — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

Access & Security 2

Authentication, authorization, and security posture

Commercial 1

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

← All providers · Data indexed from github.com/api-evangelist/aider · machine-readable index on apis.io