terminal-first review

Review your coding agent, in the terminal.

cueloop is a review surface for the plans and diffs a coding agent produces. The agent submits an artifact and blocks. You read it in the terminal, annotate it, and return a verdict. Your annotations become structured feedback the agent acts on.

The core loop

One loop, four hops. The agent submits; you review; the verdict flows back; the agent acts on it.

The daemon is the only stateful part. Every client is a thin renderer over one local unix socket, so a verdict is never lost, even if the agent-side wait times out.

Concepts

Four short pages that explain how cueloop thinks about a review.

• The ReviewSession

  The core primitive: an artifact plus quote-anchored annotations.

• Annotations

  Quote-anchored notes with stable, client-minted ids.

• Plan, diff, review

  The three verbs that open a review over an artifact.

• Sharing over SSH

  The design direction: hand a review to a terminal, no browser.

The three verbs

Each verb opens a ReviewSession over a different artifact.

• plan - an agent (Claude Code and pi today; Codex planned) submits its plan and blocks on your verdict through a hook.
• diff - cueloop diff reviews your working tree, untracked files included.
• review - pull-request review is planned (cueloop review <pr>).

This is alpha software. Expect rough edges and breaking changes between versions. The SSH gateway is a design direction, not a shipped feature.