vjuu GitHub

Review for agent handoffs

vjuu [vjuː]: "view", in rally English.

Don't open the file. Your agent already did.

When an agent would say "open this and review it", it runs vjuu instead. A window opens with the markdown, diff or source. You comment on lines, click Done, and your comments go back to the agent as markdown, anchored to file:line.

Install Source on GitHub
vjuu showing a markdown plan with two comments attached to lines, a table of contents on the left and a Done button at the bottom.
A plan, with a comment on two of its lines.
vjuu showing a syntax-highlighted Rust diff with a comment under one added line and a file list on the left.
A diff, with a comment under the added line.

How it works

Fast enough to stay in the loop.

After the first window, vjuu keeps a pre-warmed one ready. A markdown file appears in about 15 ms. "Ai biliiv täts priti fääst."

  1. Open

    Anything the agent wrote.

    Markdown, diffs and patches, git diff ranges, any source file, or stdin. Several files stack in one window.

  2. Comment

    On a line or a selection.

    Click a line, or select across lines, paragraphs or diff rows. Keyboard first: arrows to move, Enter to comment, Ctrl+Enter when done.

  3. Return

    Markdown on stdout.

    The agent gets every comment with its file:line and the quoted lines. Each review is also saved, and vjuu last prints it again.

# Review: docs/plan.md (2 comments)

## docs/plan.md:9
> 3. Hand each new document to it over a named pipe.

What happens when two agents call vjuu at the same time?

## docs/plan.md:14
> - A stale pipe after a crash must not block the next call.

Add a test for this one.

Install

Windows, macOS and Linux.

Uses the system web view: WebView2 on Windows, WKWebView on macOS, WebKitGTK 4.1 on Linux (Debian 12+, Ubuntu 22.04+).

Windows
winget install vjuu
macOS
brew install kimvais/tap/vjuu

Not signed or notarised. Homebrew installs work as is; a binary downloaded by hand needs xattr -d com.apple.quarantine vjuu once.

Debian, Ubuntu
curl -fsSL https://vjuu.it/apt/vjuu.gpg | sudo tee /usr/share/keyrings/vjuu.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/vjuu.gpg] https://vjuu.it/apt stable main" | sudo tee /etc/apt/sources.list.d/vjuu.list
sudo apt update && sudo apt install vjuu
Anything else
cargo install --locked --git https://github.com/kimvais/vjuu

Or a .zip, .tar.gz or .deb from GitHub Releases. Building on Linux needs libwebkit2gtk-4.1-dev and libgtk-3-dev.

Then, for Claude Code and Codex
vjuu setup

Installs the skill that tells your agents to run vjuu instead of asking you to open files. Run it again after an upgrade.