Roberto Bortolaso
VS Code Extension + MCP

Block-level review for agent artifacts.

Orbit lets you review generated artifacts directly in VS Code with semantic, block-anchored comments. Agents participate in the review cycle via MCP tools — generating artifacts, reading feedback, and waiting for approval before proceeding.

View on GitHub
BlocksComments anchor to content, not line numbers.
MCPAgents join the review via tool calls.
FSMDraft to approved with auto-staleness.
Problem

Line annotations break. Agents can't review. State is manual.

Problem

Fragile anchors

Traditional annotations attach to line numbers that shift on every edit, losing context and creating noise.

Problem

No agent participation

Agents generate artifacts but have no structured way to read feedback, reply to threads, or wait for approval.

Problem

Manual state tracking

Review state lives in your head. No machine-readable transitions, no automatic staleness detection on edits.

Block parsing

Stable IDs that survive edits.

Source documents are parsed into semantic blocks with content-derived IDs. Comments attach to blocks, not positions — they stay relevant through rewrites.

MCP integration

Agents as first-class reviewers.

MCP tools let agents generate resolved artifacts, add comments, reply to threads, and wait for approval — creating a human-in-the-loop workflow.

Review state machine

Transitions you can trust.

Draft, in_review, approved, changes_requested — with automatic staleness detection when the source document changes after review.

Workflow

A review loop that includes the agent.

Orbit turns artifact review into a structured cycle: write, resolve, review, decide. Agents and humans share the same review surface.

1. Write the source documentAuthor a plan, spec, or design doc — or let an agent generate one.
2. Generate the resolved artifactOrbit parses the document into semantic blocks with stable IDs for anchoring.
3. Review with block commentsLeave comments anchored to content blocks. Agents can read and reply via MCP.
4. Approve or request changesTransition the review state. Edits to the source automatically mark the review stale.

Review artifacts with semantic precision.

Orbit brings structured, block-level review to VS Code — for both humans and agents.

View on GitHub