# PRTL

> An agent-first execution plane for durable coding-agent sessions on real machines.

PRTL runs ACP-compatible agents on macOS, Windows, and Linux from one non-interactive,
JSON-speaking CLI. It owns runtime truth: attempts, sessions, nodes, worktrees,
policy, and detailed evidence. Beads remains authoritative for goals, issues,
dependencies, acceptance criteria, readiness, and semantic claims.

## Install

macOS and Linux:

    curl -fsSL https://prtl.space/install.sh | sh

Windows PowerShell:

    irm https://prtl.space/install.ps1 | iex

The current channel contains unsigned, revision-pinned development snapshots.

## Core commands

    prtl run --agent codex --node studio --repo prtl --task "..."
    prtl status --json
    prtl doctor --strict --json
    prtl show <session-id> --json

## Product boundary

- Beads tells agents what should happen.
- PRTL tells agents what is happening, where it ran, and what happened.
- PRTL is model-free and does not duplicate the semantic work graph.
- The CLI is the complete agent integration surface.