# Automaintainer

> The autonomous improvement platform — a fleet of AI agents runs a verified
> build→review→fix loop on your repos and opens merge-ready PRs, on your own
> provider keys (BYOK). Orchestrate it from a CLI: `am-cloud platform …`.

One-shot (add-if-missing → run → wait for the verified PR):

```
am-cloud platform repo run --repo <github-url> --focus "<goal>" --wait
```

## Start with the agent cheatsheet

- [Agent cheatsheet](https://automaintainer.intrane.fr/docs/agent-cheatsheet.md): one-page CLI orchestration recipe — commands, JSON contract, copy-paste loops.
- [MCP server](https://automaintainer.intrane.fr/docs/mcp-server.md): drive AM as native MCP tools from an agentic terminal (`am-cloud mcp`, stdio).

## Start here

- [What is Automaintainer](https://automaintainer.intrane.fr/docs/overview.md)
- [How it works](https://automaintainer.intrane.fr/docs/how-it-works.md)
- [Trust ladder & plans](https://automaintainer.intrane.fr/docs/trust-and-plans.md)
- [Quickstart](https://automaintainer.intrane.fr/docs/quickstart.md)

## Connect

- [Connect GitHub](https://automaintainer.intrane.fr/docs/connect-github.md)
- [Enterprise SSO](https://automaintainer.intrane.fr/docs/sso.md)
- [Add a repository](https://automaintainer.intrane.fr/docs/add-repository.md)
- [Add a worker](https://automaintainer.intrane.fr/docs/add-worker.md)
- [BYOK provider keys](https://automaintainer.intrane.fr/docs/byok-provider-keys.md)
- [SSH keypairs](https://automaintainer.intrane.fr/docs/ssh-keypairs.md)
- [Verify readiness](https://automaintainer.intrane.fr/docs/verify-readiness.md)

## Define the work

- [Focus](https://automaintainer.intrane.fr/docs/focus.md)
- [Examples & use cases](https://automaintainer.intrane.fr/docs/examples.md)
- [Playbooks](https://automaintainer.intrane.fr/docs/playbooks.md)
- [Profile presets](https://automaintainer.intrane.fr/docs/profile-presets.md)
- [Objectives & acceptance](https://automaintainer.intrane.fr/docs/objectives.md)
- [The Verification Gate](https://automaintainer.intrane.fr/docs/verification-gate.md)
- [Teams & models](https://automaintainer.intrane.fr/docs/teams-and-models.md)
- [QA role vs reviews](https://automaintainer.intrane.fr/docs/qa-role-vs-reviews.md)

## Autonomy

- [Scheduling](https://automaintainer.intrane.fr/docs/scheduling.md)
- [Scheduler priority](https://automaintainer.intrane.fr/docs/scheduler-priority.md)
- [Throttling open PRs](https://automaintainer.intrane.fr/docs/throttling-open-prs.md)
- [Explore mode](https://automaintainer.intrane.fr/docs/explore-mode.md)
- [Issue solving](https://automaintainer.intrane.fr/docs/issue-solving.md)
- [Issue scout](https://automaintainer.intrane.fr/docs/issue-scout.md)
- [PR watcher](https://automaintainer.intrane.fr/docs/pr-watcher.md)
- [Auto-merge](https://automaintainer.intrane.fr/docs/auto-merge.md)

## Operate

- [Reading a run](https://automaintainer.intrane.fr/docs/reading-runs.md)
- [Run costs](https://automaintainer.intrane.fr/docs/run-costs.md)
- [Worker & fleet health](https://automaintainer.intrane.fr/docs/worker-health.md)
- [Memory](https://automaintainer.intrane.fr/docs/memory.md)
- [Recovering a PR](https://automaintainer.intrane.fr/docs/recovering-a-pr.md)

## Troubleshoot

- [Dashboard buttons do nothing](https://automaintainer.intrane.fr/docs/dashboard-not-responding.md)
- [My run made no changes](https://automaintainer.intrane.fr/docs/no-changes.md)
- [Provider & model errors](https://automaintainer.intrane.fr/docs/provider-errors.md)
- [Worker not ready](https://automaintainer.intrane.fr/docs/worker-not-ready.md)
- [Gate failures](https://automaintainer.intrane.fr/docs/gate-failures.md)

## Reference

- [Roadmap](https://automaintainer.intrane.fr/docs/roadmap.md)
- [Plans & limits](https://automaintainer.intrane.fr/docs/plans-and-limits.md)
- [Budgets & spend caps](https://automaintainer.intrane.fr/docs/budgets.md)
- [am-cloud CLI](https://automaintainer.intrane.fr/docs/cli.md)
- [Operator admin CLI](https://automaintainer.intrane.fr/docs/admin-cli.md)
- [Environment variables](https://automaintainer.intrane.fr/docs/environment-variables.md)
- [API reference](https://automaintainer.intrane.fr/docs/api.md)
- [API key](https://automaintainer.intrane.fr/docs/api-key.md)
- [Security & data](https://automaintainer.intrane.fr/docs/security.md)
- [Account recovery](https://automaintainer.intrane.fr/docs/account-recovery.md)
- [Billing & cancellation](https://automaintainer.intrane.fr/docs/billing.md)