tdiff ∓

Talk to your agent on the diff

tdiff gives you a local diff review canvas where humans and coding agents talk directly on changed lines. Open a terminal review, leave feedback, and let your agent watch, reply, fix, or wait for approval.

Star on GitHub Install

Built for feedback that agents can act on

+ thread Review threads

Feedback attaches to exact lines/ranges in your local diff.

+ inbox Agent inbox

Agents discover open review work without copy/paste.

+ reply In-thread replies

Human and agent messages stay in one durable thread.

+ approve Approval-aware

Agents can wait for approval before continuing work.

+ sync GitHub sync

Pull PR review threads into the same local review.

+ events Event stream

Agents watch review changes and react when state changes.

Agent workflow

Agents watch the review stream, inspect JSON context when needed, reply in-thread, and continue after approval.

tooltdiff agent inbox --json
[{"thread_id":"T42","actor":"owenps","path":"internal/review/gate.go","line_start":27,"line_end":29,"body":"approval should block on open threads"}]
new review thread T42 from owenps; inspecting context
tooltdiff thread show T42 --json
status=open target=internal/review/gate.go:27-29 body="approval should block on open threads"
toolgo test ./...
ok ./...
tooltdiff thread reply T42 --actor agent --body "Fixed; added regression test"
E179 thread.replied thread_id=T42 actor=agent body_preview="Fixed; added regression test"
tooltdiff thread resolve T42 --actor agent
E180 thread.status_changed thread_id=T42 actor=agent status=resolved
tooltdiff review watch
E181 review.approved actor=owenps diff_hash=9f2c...
approval received; continuing task

tool running: tdiff agent inbox --json review approved

Install

go install github.com/owenps/tdiff@latest && tdiff

Agent instructions live at:

tdiff agent help

Read the README for keybinds and development notes.