# Loopwright

> Loopwright is a nine-package TypeScript harness and GitHub Action/App control plane for bounded, verified work.

Documentation version: main. Source revision: 61c8b28e1430f9c44a816f9b865665ee4ace33c7.
These pages come from the repository's docs/ sources. For version-specific behavior, use the
documentation and code for your release. This index routes questions; follow its links for evidence.

## Interactive Bootstrap Protocol

1. Choose an operating mode with the user: Declarative Taskpack Mode (simple single-file .loopwright/taskpack.yaml + GitHub Action/App for repository sync and PRs) or Managed Controller Mode (out-of-repo TrustedRegistry registry.yaml + SHA-256-pinned ControllerConfig controller.yaml + TaskContract for fine-grained CLI governance).
2. Fetch the Markdown exports listed below for the chosen mode before generating YAML (Declarative Taskpack Walkthrough + Taskpack Manifest Reference + GitHub Action Configuration for Mode 1; Managed Controller Walkthrough + Task Contracts and Schemas + Controller and Trusted Registry for Mode 2).
3. Inspect the target repository (including existing automatic synchronized workflows, release scripts, version manifests, and folder layout) and confirm upstream sources, writable/protected scope, verification checks, and PR publication settings interactively with the user.
4. Emit two-space Pretty YAML with apiVersion: loopwright.dev/v1alpha1, keep .loopwright/memory/<id> outside writable scope, and never embed raw secrets or untrusted ${ENV} interpolation inside taskpack.yaml.

## Getting Started

- [Architecture](/loopwright/latest/docs/getting-started/architecture/index.md): Execution stages, trust boundaries, and configuration map
- [Installation](/loopwright/latest/docs/getting-started/installation/index.md): Install the CLI on a laptop or wire the GitHub Action

## Operations

- [GitHub Action](/loopwright/latest/docs/operations/github-action/index.md): Configure and run the reusable GitHub Action
- [GitHub App](/loopwright/latest/docs/operations/github-app/index.md): Deploy and configure the GitHub App control plane
- [CLI](/loopwright/latest/docs/operations/cli/index.md): Generate drafts, inspect runs, reconcile, and audit closure

## Walkthroughs

- [Declarative Taskpack](/loopwright/latest/docs/walkthroughs/declarative-taskpack/index.md): Author or migrate a single-file repository taskpack
- [Managed Controller](/loopwright/latest/docs/walkthroughs/managed-controller/index.md): Configure out-of-repo registries, contracts, and CLI runs

## Configuration

- [Taskpack](/loopwright/latest/docs/configuration/taskpack/index.md): Configure every field and enum in .loopwright/taskpack.yaml
- [Task Contract](/loopwright/latest/docs/configuration/task-contract/index.md): Configure task goals, scope, roles, budgets, DAGs, and evidence
- [Controller and Registry](/loopwright/latest/docs/configuration/controller-and-registry/index.md): Configure approved handlers, profiles, credentials, and controls
- [Sandbox Backends](/loopwright/latest/docs/configuration/sandbox-backends/index.md): Select OS or container sandboxes and required capabilities
- [Decision Routing](/loopwright/latest/docs/configuration/decision-routing/index.md): Configure advisory routing policies, providers, and thresholds

## Optional

- [Repository navigation](https://github.com/gpustack/loopwright/blob/61c8b28e1430f9c44a816f9b865665ee4ace33c7/docs/README.md): Module relationships, design records, code entry points and applicable skills for contributors.