---
title: "Threads"
description: "What threads and runs are, and where to learn each part of the workflow"
canonical_url: "https://hoplite.sh/docs/threads"
markdown_url: "https://hoplite.sh/docs/threads.md"
---

# Threads
URL: /docs/threads
LLM index: /llms.txt
Description: What threads and runs are, and where to learn each part of the workflow
Related: /docs/quickstart, /docs/sandboxes, /docs/github

# Threads

A **thread** is a single conversation and task against a project. Each thread gets its own [sandbox](/docs/sandboxes), its own diff, and its own pull requests — the conversation, the code changes, and the PRs stay one unit of work.

Within a thread, each of your messages kicks off a **run**: one agent execution turn. Tool calls stream into the thread as the agent works, sensitive actions pause for your [approval](/docs/threads/review#approvals), and the thread's [status](/docs/threads/manage#thread-statuses) tells you when it needs you.

## The thread workflow

| Page | What it covers |
| --- | --- |
| [Run a thread](/docs/threads/run) | Start work, queue messages mid-run, stop and steer, retry, attach files, manage the context window |
| [Review and approve work](/docs/threads/review) | The activity timeline, the approvals model, agent tasks, subagents, and inline references |
| [Manage threads](/docs/threads/manage) | Statuses, titles and labels, notes, transcript export, and organization history |
| [Track cost](/docs/threads/cost) | The running cost chip, per-run usage attribution, and the BYOK badge |

`/stop` durably requests cancellation for the run you are viewing. Hoplite shows **Stopping** until the worker finishes terminalization, and messages sent afterward queue for the next run.

## Beyond the conversation

When the agent starts your app, a **Preview panel** shows it live inside the thread and a **Terminal panel** gives you a shell into the sandbox — see [Previews](/docs/sandboxes/previews). Once a thread has a live PR, the **PR rail** slides out with its checks, reviews, and unresolved comments — see [Pull requests](/docs/github).

## Sitemap

See the full [sitemap](/docs/sitemap.md) for all pages.
Well-known sitemap: [/docs/.well-known/sitemap.md](/docs/.well-known/sitemap.md).