Overview
What Meshvy is, what it needs, and the three ideas the rest of these pages build on.
Meshvy is a native macOS app for running coding agents across several repositories at once. It cuts one branch across the repositories you pick, checks each out side by side, and puts a real Claude Code session — with its own terminal — on every one of them, on an infinite canvas.
What you need
macOS 14 or later, Apple Silicon or Intel, and Claude Code installed and signed in — Meshvy drives the
claude CLI rather than the API.Three ideas
Everything else in these pages is detail on one of these, and they are worth reading in this order.
- A workspace is one branch, not one repository. You name it, pick the repositories it spans and choose the base branch to cut from. Meshvy cuts the same branch in each, as a real
git worktree, all under one folder. - Every agent is a terminal you can type into. The orchestrator runs at the workspace root, with every repository as a subdirectory beneath it, and delegates to per-repository agents you can read, interrupt and answer.
- The board reads your machine. Nodes are drawn from transcripts on disk, live ptys and real pages — not from a model of what you did.
~/.meshvy/payments-revamp/ api/ → repo “api” on payments-revamp web/ → repo “web” on payments-revamp worker/ → repo “worker” on payments-revamp
Every page
Getting started
One command, or the DMG. What it puts where, and how to check the build is really ours.
Concepts
One branch, cut as a git worktree in every repository you picked, all under one folder.
The orchestrator, the agents it dispatches, and the helper it delegates through.
Five kinds of node, where each one gets its facts, and the two views that read across them.
The running application on the canvas next to the agents building it — and drivable by them.
Reference