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.
The minimum
Section titled “The minimum”- 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.
What each feature needs
Section titled “What each feature needs”| 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 and macOS
Section titled “Linux and macOS”| 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 |
Providers
Section titled “Providers”| 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.
Clients
Section titled “Clients”| 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. |