---
title: "Hoplite documentation"
description: "Build, run, and ship with Hoplite coding agents, managed cloud workspaces, and the public API."
canonical_url: "https://hoplite.sh/docs"
markdown_url: "https://hoplite.sh/docs.md"
---

# Hoplite documentation
URL: /docs
LLM index: /llms.txt
Description: Build, run, and ship with Hoplite coding agents, managed cloud workspaces, and the public API.

# Hoplite documentation

Hoplite is a coding-agent platform for turning repository tasks into pull requests. Run agents in managed cloud workspaces, work with local providers in the desktop app, or build your own cloud software factory through the public API. Hoplite brings agent execution, persistent workspaces, previews, approvals, and PR operations together so you can focus on the work you want to ship.

## Execution

A cloud thread owns its workspace across runs. Separate threads have separate workspaces; follow-up messages resume the existing one. Local threads in the desktop app run against a folder or Git worktree on your machine.

- [Cloud setup](/docs/quickstart) — connect a repository and start a thread.
- [Threads and runs](/docs/threads) — execution boundaries, concurrency, and continuation.
- [Thread workspace lifecycle](/docs/sandboxes) — persistence, archive, recovery, and runtime replacement.
- [Desktop execution](/docs/desktop) — local providers, credentials, and cloud differences.

## Configuration and control

- [Repository setup](/docs/agent-ready) — install dependencies and configure managed previews.
- [Instructions](/docs/agent/instructions) and [skills](/docs/agent/skills) — scope and discovery.
- [Permissions](/docs/agent/tools) — which operations can proceed and which pause for approval.
- [Security boundaries](/docs/workspace/security) — what enters the workspace and who can access it.
- [Costs and limits](/docs/workspace/billing) — billing attribution, credit holds, and spending caps.

## Build on Hoplite

[Build a software factory](/docs/factory) walks through a backend integration that starts a budgeted task and produces a draft PR. Use [events](/docs/factory/events) to build a live UI, [webhooks](/docs/factory/webhooks) to trigger workflows, and [operation receipts](/docs/factory/retries) to recover from uncertain writes.

The [API reference](/docs/api) documents request and response schemas. Download the [OpenAPI specification](/docs/openapi.json) for client generation.

## Sitemap

Sitemap discovery is not enabled for this deployment.