Install Vendetta
Linux or macOS, a Rust toolchain, a provider you already use, and a phone to pair.
What you need
| A computer | Linux, or macOS 13 or newer. It should stay on while you're away. |
| Rust | A stable toolchain. Vendetta is built from source. |
| To build on Linux | A C toolchain, pkg-config, clang, and the ALSA and PipeWire development files. |
| A provider you already use | Claude Code, Codex, omp, OpenCode, Gemini CLI, or Aider, with its own login. |
| tmux | Optional. 3.3 or newer adds pane navigation, live previews, and managed agents. |
| Bun | Optional. With it, the installer builds the web client. |
| A phone to pair | The iPhone app on TestFlight, or any browser. |
From clone to first agent
Build and install
install.shputs the binaries in~/.local/bin, withvtas a short name, and hooks up each provider it finds without touching your other settings. Put that folder on yourPATH.$ git clone https://github.com/vendetta-sh/vendetta.git $ cd vendetta $ bash install.shStart the worker
The chooser, the apps, and every plugin get their agents from it. Restart any agents that were already running, so they load their integration.
$ vendetta notify startOpen the chooser
Run it anywhere. Agents you start in any terminal are listed. In tmux, the worker binds the key you name under
[plugins.host-tmux.keys]in the config, such aschooser = "alt+s".$ vendetta tuiPublish the app port privately
The apps talk to one WebSocket on your machine. It listens on loopback until you publish it, for example on your tailnet. Set the address, restart the worker, and serve the port.
~/.config/vendetta/config.toml[plugins.app] public_url = "wss://workstation.your-tailnet.ts.net:8743/v1"Serve it and pair your phone
Scan the QR code in the iPhone app, or open the address in a browser and enter the server and code. A code works once, within 10 minutes.
$ vendetta notify stop && vendetta notify start $ tailscale serve --bg --https=8743 http://127.0.0.1:8743 $ vendetta app pairStart an agent
Start Claude Code, Codex, or any provider the way you always do. It shows in the chooser with its state, and as a chat on your phone.
Where to go next
- The full install guide: provider integrations, upgrading, macOS, tmux setup.
- Connect your phone and browser: publishing the port, pairing, and revoking a device.
- Your first agent: starting one, answering it, and restoring it.
- Telegram and Discord take a bot token and your user ID.