<p align="center">
<img src="icons/icon.svg" width="80" alt="">
</p>
<h1 align="center">snyvi</h1>
<p align="center">A fast, beautiful viewer for the documents your agents produce.</p>
<p align="center">
<a href="https://github.com/snymrova/snyvi/releases/latest"><img src="https://img.shields.io/github/v/release/snymrova/snyvi?style=flat-square&color=c8420f&label=release" alt="latest release"></a>
<a href="https://github.com/snymrova/snyvi/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/snymrova/snyvi/ci.yml?style=flat-square&label=ci" alt="ci"></a>
<img src="https://img.shields.io/badge/linux%20%C2%B7%20macos%20%C2%B7%20windows-one%20static%20binary-555?style=flat-square" alt="Linux, macOS and Windows, one static binary">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-555?style=flat-square" alt="MIT"></a>
</p>
https://github.com/user-attachments/assets/21f7e4b9-f2e6-441a-975c-c876504ed583
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/media/plan-dark.webp">
<img src="docs/media/plan-light.webp" width="900" alt="A plan open in snyvi: the library in the sidebar, the document in the middle, its contents in the rail on the right">
</picture>
</p>
Ask Claude Code (or any agent) for a plan, and it opens in snyvi:
rendered, searchable, and filed under its project. Markdown, diagrams and
source code. Everything stays on your machine.
## Install
**Windows**: download `snyvi-*-setup.exe` from the
[latest release](https://github.com/snymrova/snyvi/releases/latest) and
double-click it. That's it: it connects Claude Code (if you have it) and
opens snyvi.
(Windows warns that the installer isn't signed: *More info* → *Run anyway*.)
**macOS**:
```
brew install --cask snymrova/snyvi/snyvi
snyvi init-claude --auto
```
**Debian / Ubuntu**: download `snyvi_*.deb` from the
[latest release](https://github.com/snymrova/snyvi/releases/latest), then:
```
sudo dpkg -i snyvi_*.deb
snyvi init-claude --auto
```
Other Linux, a Mac without Homebrew, `cargo install snyvi`, and the native
window on Linux: see the [install guide](docs/GUIDE.md#install).
## Use it
In Claude Code, ask for a plan. It opens in snyvi by itself.
`init-claude --auto` sends every Markdown file Claude writes. Leave out
`--auto` and Claude sends only when it decides to, or when you ask.
Other agents are one command each:
```
snyvi init codex # also: cursor, claude-desktop, gemini, windsurf, vscode, zed
```
From a terminal:
```
snyvi send PLAN.md # open a file (or stdin) and print its link
snyvi watch PLAN.md # and again every time it is saved
snyvi app # open the viewer
snyvi status # what is running and what is connected
```
In the viewer: `⌘K` / `Ctrl+K` searches everything, `n` opens the next new
document, `c` shows what changed since the last version, `?` lists every key.
## Update and remove
Install the new version over the old one. On Linux, run `snyvi restart`
afterwards; on macOS use `brew upgrade`; the Windows installer handles it.
To remove snyvi: `snyvi uninstall-claude`, then uninstall it the way you
installed it. Your documents are kept until you run `snyvi reset`.
## More
- [Guide](docs/GUIDE.md): every platform, command, agent and key.
- [Roadmap](docs/ROADMAP.md): what shipped, and why.
- Fast: a send takes about 13 ms, and `snyvi bench --check` holds every number
to a budget on every push ([numbers](docs/GUIDE.md#measured-so-far)).
MIT licensed.