---
title: "Threads and runs"
description: "Keep a task’s conversation, execution workspace, code changes, and pull requests together."
canonical_url: "https://hoplite.sh/docs/threads"
markdown_url: "https://hoplite.sh/docs/threads.md"
---

# Threads and runs
URL: /docs/threads
LLM index: /llms.txt
Description: Keep a task’s conversation, execution workspace, code changes, and pull requests together.
Related: /docs/quickstart, /docs/sandboxes, /docs/github

# Threads and runs

Keep a coding task's conversation, workspace, diff, and linked PRs together in a cloud thread. Runs are executions within that thread, and follow-up runs reuse its workspace so work can continue from the current files and processes. [Local threads](/docs/desktop) use a folder or Git worktree on your machine instead.

## Concurrency and continuation

Separate cloud threads have separate workspaces and can run concurrently. Changes meet when their branches are published or merged; filesystem isolation does not prevent Git conflicts between tasks editing the same code.

A message can start a new run, queue behind the current run, or steer it. [Run a thread](/docs/threads/run#send-messages-while-the-agent-works) defines those choices. Closing the browser does not cancel cloud execution.

Archiving can stop the underlying runtime while retaining the thread's workspace state. Restoring it resumes the worktree, but processes may need restarting. See [Workspace lifecycle](/docs/sandboxes).

## 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, 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

Sitemap discovery is not enabled for this deployment.