# Risoluto

## Docs

- [Assistant](https://docs.risolu.to/.mintlify/Assistant.md)
- [AGENTS](https://docs.risolu.to/AGENTS.md)
- [CLAUDE](https://docs.risolu.to/CLAUDE.md)
- [All Endpoints](https://docs.risolu.to/api-reference/endpoints.md): Complete reference of all Risoluto REST API endpoints — state, issues, attempts, config, secrets, templates, workspaces, audit, and webhooks.
- [API Reference](https://docs.risolu.to/api-reference/overview.md): Understand the Risoluto API surface before you drill into individual endpoints: base URL, auth rules, response format, and the main endpoint groups.
- [Changelog](https://docs.risolu.to/changelog.md): Release history and notable changes in each Risoluto version. Track new features, dashboard updates, security improvements, and bug fixes.
- [How It Works](https://docs.risolu.to/concepts/how-it-works.md): Understand Risoluto's architecture — how issues are polled from Linear, dispatched to sandboxed Docker agents, and delivered as GitHub pull requests.
- [Runtime Behavior](https://docs.risolu.to/concepts/runtime.md): How Risoluto manages agent lifecycle at runtime — polling intervals, webhook scheduling, timeout configuration, retry logic, and the issue state machine.
- [Trust Model](https://docs.risolu.to/concepts/trust-model.md): Risoluto's trust model and security boundaries — sandbox policies, Docker isolation, credential encryption, egress controls, and local-first operation.
- [FAQ](https://docs.risolu.to/faq.md): Short answers to the questions operators usually ask first: setup path, privacy, Docker, models, cost, monitoring, and failure handling.
- [Configuration Reference](https://docs.risolu.to/guides/configuration.md): Complete reference for all Risoluto configuration options — server, polling, tracker, agent, codex, workspace, sandbox, secrets, and notification settings.
- [Dashboard](https://docs.risolu.to/guides/dashboard.md): Use the Risoluto dashboard to watch live runs, inspect issue history, adjust configuration, and trace what the orchestrator is doing.
- [Docker Deployment](https://docs.risolu.to/guides/docker.md): Deploy Risoluto with Docker Compose for persistent operation. Covers zero-config wizard start, named volumes, networking, and control/data plane split.
- [Notifications & Git](https://docs.risolu.to/guides/notifications.md): Configure Slack notifications for agent lifecycle events, set up Linear webhooks for real-time dispatch, and automate Git workflows for PR creation.
- [Security](https://docs.risolu.to/guides/security.md): Harden your Risoluto deployment with bind address controls, write tokens, AES-256 credential encryption, egress allowlists, and gVisor sandbox isolation.
- [Setup Wizard](https://docs.risolu.to/guides/setup-wizard.md): Understand the first-run setup wizard: what each step asks for, what it stores, and how to rerun setup safely later.
- [Introduction](https://docs.risolu.to/introduction.md): Start with the recommended Risoluto path, understand what the system does, and find the next document you need without wading through the whole site.
- [Observability](https://docs.risolu.to/operating/observability.md): Monitor Risoluto with Prometheus metrics, real-time SSE event streams, audit logs, X-Request-ID tracing, Sentry error tracking, and structured Pino logs.
- [Troubleshooting](https://docs.risolu.to/operating/troubleshooting.md): Diagnose and fix common Risoluto issues — startup failures, agent OOMs, stalled workers, Docker problems, Linear connectivity, and credential errors.
- [Quickstart](https://docs.risolu.to/quickstart.md): Use the recommended Docker + setup wizard path to get Risoluto running and confirm your first automated issue flow.
- [Custom Sandbox Image](https://docs.risolu.to/recipes/custom-sandbox.md): Build a custom Docker sandbox image with Python, Go, Rust, or other runtimes and pre-installed dependencies for faster Risoluto agent startup.
- [Monitoring Stack](https://docs.risolu.to/recipes/monitoring-stack.md): Set up Prometheus and Grafana to monitor Risoluto — includes scrape config, dashboard queries for agent success rates, and alert rules for failures.
- [Multi-Repository Setup](https://docs.risolu.to/recipes/multi-repo.md): Route issues from a single Linear project to multiple Git repositories using identifier prefix matching or label-based routing rules.

## OpenAPI Specs

- [openapi](https://docs.risolu.to/openapi.json)