Skip to content
Docs0.9GitHubInstall

Running itRequirements and platforms

Requirements and platforms

What Vendetta runs on, what each feature needs installed, and what each provider supports.

What to have on the computer your agents run on before you install, for whoever administers it. The clients (a browser, an iPhone, Telegram, Discord) need nothing installed on that computer beyond what is listed here.

  • Linux, or macOS 13 or newer.
  • A stable Rust toolchain. Vendetta is built from source by install.sh.
  • At least one providerProvider. The program an agent runs: Claude Code, Codex, omp, OpenCode, Gemini CLI, or Aider. from the table below, installed and logged in. Vendetta brings no agent of its own.

On Linux the build also needs a C toolchain, pkg-config, clang, and the ALSA and PipeWire development files.

Then follow Install.

For You need
Panes, live previews, and agents Vendetta starts in tmux tmux 3.3 or newer; 3.5 or newer for extended-keys-format. Tested with 3.5a and 3.8. On macOS, tmux from Homebrew.
Kitty as the terminal host Kitty with a remote-control socket (listen_on in kitty.conf). See Terminals.
The web client Bun, Rust’s wasm32-unknown-unknown target, and wasm-bindgen-cli at the version crates/kit/Cargo.toml pins, at install time. wasm-opt from binaryen makes it smaller. Without Bun or wasm-bindgen, install.sh skips the web client and says so.
Reaching the apps away from the computer A private address for the app port: a tailnet or your own reverse proxy. See Publish the apps privately.
A QR code when pairing qrencode. Without it, pairing prints a link and a code.
iPhone push and Live Activities An app build signed by your own team, its APNs key in [plugins.app.apns], and curl with HTTP/2. See The iPhone app.
Voice notes and dictation A transcription provider in [plugins.speech.transcription]: a local command or a service. On Linux, ffmpeg converts recordings that are not 16-bit mono WAV; elsewhere those are refused. See Voice.
Replies read in a voice of your choice [plugins.speech.narration]. Without it, the apps read with the device’s own voice.
The desktop HUD Hyprland with GTK 4.20 or newer and gtk4-layer-shell, or macOS with the Vendetta app.
Desktop dictation On Hyprland: the HUD’s requirements, hyprctl with the Lua API, and wl-copy. On macOS: the Vendetta app.
Desktop-wide shortcuts Hyprland with its Lua config, or macOS with the Vendetta app.
Desktop notifications On Linux, notify-send and a notification daemon. On macOS, Notification Center.
vendetta:// links that open an agent xdg-mime, on Linux.
The scheduler from login A systemd user manager on Linux; launchd on macOS. See Run at login.
Project machines Docker or Podman. See Project machines.
People Rootless Podman and loginctl enable-linger. See People.
Icons A Nerd Font, optional. Every glyph has a text fallback.
Linux macOS 13+
Worker, scheduler, chooser, app endpoint Yes Yes
tmux as host Yes Yes, with tmux from Homebrew
Worker and scheduler from login Scheduler by install.sh; the worker with a unit you enable Both by install.sh, through launchd
Claude Code, Codex, Gemini CLI, Aider state Yes Yes
omp and OpenCode state Yes No. Their integrations read /proc, so those agents report no state.
Desktop HUD Hyprland Drawn by the Vendetta app
Kitty HUD Hyprland No
Dictation Hyprland: sends to the focused agent, or pastes The Vendetta app: always pastes, never sends to an agent
Desktop-wide shortcuts Hyprland While the Vendetta app runs
Sockets Under XDG_RUNTIME_DIR In ~/.local/state, as macOS has no XDG_RUNTIME_DIR
Provider Version Live state from Replies in chat Questions as buttons Started and resumed by Vendetta
Claude Code 2.1.296 or newer Its native Mod From its transcript Yes Yes
Codex Hooks, or its rollout files From its transcript No Yes
omp 18.1.14 or newer for questions Extension From its transcript Yes Yes
OpenCode v2 SDK APIs for questions Plugin Terminal snapshot Yes Yes
Gemini CLI Hooks Terminal snapshot No Listed when you start it
Aider 0.86.2 The vendetta-aider launcher Terminal snapshot No Listed when you start it

Notes by platform and setup:

  • macOS: omp and OpenCode agents are found but report no state.
  • Without tmux or Kitty: Claude Code, omp, and OpenCode still take prompts, questions, and interrupts through their own integrations. Prompts to Codex, Gemini CLI, and Aider are typed into a terminal, so they need a host.
  • Approvals from the apps: Claude Code’s permission dialog shows as a card with Allow once and Deny. Other providers’ approvals, and a Claude subagent’s, are answered at the terminal.
  • Project machinesMachine. One container that runs a project's agents on a private clone of the project. run Claude Code only, and have no Master.
  • Aider versions other than 0.86.2 run unobserved with a warning, and its conversations cannot be resumed.
  • OpenCode with opencode attach: the plugin runs in the server, so that pane shows as a process only.
Client Needs
Chooser and overview A terminal. Compact layout down to 20×6.
Web client A current browser that reaches the app address over HTTPS.
iPhone and iPad app iOS 17 or newer.
Telegram A bot token and your user ID. See Telegram and Discord.
Discord A bot, a private category, and a control channel.