YS/CV

01 / Systems and intelligent runtimes

SourcePin — closing the loop between UI feedback and source code for coding agents

Links page elements to DOM, component, and source locations while keeping final acceptance with the human reviewer.

GitHub Back to projects
Period
2026 — present
Status
In active development
Role
Protocol, state-machine, and tool design

The problem

When a coding agent receives feedback such as “this button is wrong,” it usually lacks stable DOM, component, and source context. After making a change, it also lacks a clear human-owned acceptance state.

Design

  • Binds UI elements to DOM, component, and source locations.
  • Exposes list, get_context, mark_changed, and related tools through CLI and MCP.
  • Uses an asymmetric open → changed-awaiting-review → accepted/reopen state machine.
  • Handles stable target recovery, routes and tabs, concurrent-write protection, paths, and symlink boundaries.
  • Supports element, text, and region handoff, including Next.js App Router surfaces.

Boundary

An agent may advance an item to changed-awaiting-review. Only a human may accept it or reopen it.