> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# Aider

> Connect Aider to Phaseo with an automatically managed configuration.

Use the Phaseo CLI to create a dedicated key and managed Aider configuration, or copy the same provider values into an existing Aider configuration yourself.

## Set up with the Phaseo CLI

```bash theme={null}
phaseo login
phaseo aider --model anthropic/claude-sonnet-4.6
```

If `~/.aider.conf.yml` does not exist, setup creates a Phaseo-managed file containing:

```yaml theme={null}
model: openai/anthropic/claude-sonnet-4.6
openai-api-base: https://api.phaseo.app/v1
openai-api-key: <dedicated Phaseo key>
```

Aider requires the `openai/` prefix to route a custom model through its OpenAI-compatible adapter. The model sent to Phaseo remains `anthropic/claude-sonnet-4.6`.

> [!WARNING]
>
> The API key is stored in plaintext because `.aider.conf.yml` is one of Aider's documented credential locations. Protect the file with your normal user-account permissions and never commit it.

If you already have an Aider configuration, the CLI stops without changing it. Merge the three values above into the configuration you want Aider to load. Aider checks the home directory, repository root, and current directory, with later files taking precedence.

## Verify

Open a repository and start Aider:

```bash theme={null}
aider
```

Confirm the startup output names `openai/anthropic/claude-sonnet-4.6`, then ask it to reply with `PHASEO_AIDER_OK`. The request should also appear in Phaseo activity.

An unknown-model warning does not prevent requests. Add Aider model metadata only if you need accurate token-limit or cost estimates.

## Remove

```bash theme={null}
phaseo integrations remove aider
```

Removal revokes the dedicated key and deletes `~/.aider.conf.yml` only when the file still has the Phaseo CLI ownership marker. If you merged Phaseo into an existing file yourself, remove the three Phaseo values manually.

## Troubleshooting

### Aider uses another endpoint or model

Check for `.aider.conf.yml` in the repository root and current directory. Those files override the home configuration. Environment variables and command-line options can also override the saved values.

### Authentication fails

Run `phaseo integrations credential aider` and compare the result with `openai-api-key`. Keep `openai-api-base` exactly `https://api.phaseo.app/v1`.

### The model cannot be resolved

Keep the Aider-only `openai/` prefix. For example, Phaseo model `openai/gpt-5.6-terra` becomes `openai/openai/gpt-5.6-terra` in Aider.

## Related

* [Aider OpenAI-compatible API documentation](https://aider.chat/docs/llms/openai-compat.html)
* [Aider YAML configuration](https://aider.chat/docs/config/aider_conf.html)
* [Coding Agents](https://phaseo.app/docs/v1/guides/integrations/coding-assistants.md)
* [Models](https://phaseo.app/docs/v1/api-reference/endpoint/models.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.