Install Vendetta

Linux or macOS, a Rust toolchain, a provider you already use, and a phone to pair.

What you need

A computerLinux, or macOS 13 or newer. It should stay on while you're away.
RustA stable toolchain. Vendetta is built from source.
To build on LinuxA C toolchain, pkg-config, clang, and the ALSA and PipeWire development files.
A provider you already useClaude Code, Codex, omp, OpenCode, Gemini CLI, or Aider, with its own login.
tmuxOptional. 3.3 or newer adds pane navigation, live previews, and managed agents.
BunOptional. With it, the installer builds the web client.
A phone to pairThe iPhone app on TestFlight, or any browser.

From clone to first agent

  1. Build and install

    install.sh puts the binaries in ~/.local/bin, with vt as a short name, and hooks up each provider it finds without touching your other settings. Put that folder on your PATH.

    $ git clone https://github.com/vendetta-sh/vendetta.git
    $ cd vendetta
    $ bash install.sh
  2. Start 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 start
  3. Open 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 as chooser = "alt+s".

    $ vendetta tui
  4. Publish 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"
  5. 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 pair
  6. Start 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