ReferenceChangelog
Changelog
What each Vendetta release contains, newest first.
What each release contains, for anyone deciding whether to upgrade. To upgrade, see Upgrade.
Vendetta makes no compatibility guarantee between releases: a release may change the config, the protocols, and the state it keeps.
The first public release. It contains:
Agents
Section titled “Agents”- Finds Claude Code, Codex, omp, OpenCode, Gemini CLI, and Aider sessions from the process list, in tmux or in any terminal, and identifies each by boot, PID, and start time.
- Live state from each provider’s own hooks, extension, plugin, or Mod: working, waiting on a question, waiting on an approval, ready, or exited.
- Questions as buttons for Claude Code, omp, and OpenCode. Claude Code’s permission dialog as a card in the apps, with Allow once and Deny.
- Agents Vendetta starts on your computer ask before they run commands. Agents in a container project don’t ask.
- Managed agents in a pinned Agents tab per project, with launch arguments, models, and efforts per provider, and an idle timeout that pauses agents and a message that resumes them.
- History of ended conversations, restored into a new pane or by a message in their chat.
- Auto-delete for stopped conversations, with a dry run, and ephemeral agents.
Terminal
Section titled “Terminal”- The chooser,
vendetta tui: projects with counts per state, jump hints, a live preview you can type into, search, filters, multi-select, history, and layouts you arrange. A compact layout below 100 columns, down to 20×6. - The overview: agents in lanes by what they need, answered on their cards.
- Schedules, tasks, and changes as screens in the chooser.
- tmux and Kitty as terminal hosts, with rebindable keys and agent states in tmux tab labels.
- Desktop-wide shortcuts on Hyprland and macOS.
Web client and iPhone app
Section titled “Web client and iPhone app”- Every agent as a chat, with replies as they stream, the working line, and the agent’s todo list.
- Voice notes, replies read aloud, and a hands-free voice mode.
- Photos, videos, and audio from the agent, with marks on places and moments, and suggested changes to a video’s narration and on-screen text tracks.
- Pages an agent writes, shown in the chat, which send to the agent and keep their state. Pinned pages.
- Alerts and timers that sound with notifications muted, and Live Activities on the iPhone’s lock screen.
- New agents and managers from the phone, a queue for after the agent’s turn, schedules, tasks, and settings.
- Simple and Advanced modes.
- Web Push in the browser and push on the iPhone.
Telegram and Discord
Section titled “Telegram and Discord”- A topic or channel per conversation, progress edited into one message, questions as buttons, and photos and voice notes as prompts.
- Only the configured owner can send input.
Master, managers, and teams
Section titled “Master, managers, and teams”vendetta agent: list, read, prompt, answer, start, resume, and rename agents. It has no shell command and never answers an approval.- A Master agent, and managers that lead teams. Teams nest, and members start muted while their manager relays what matters.
vendetta.toml: always-running agents, teams, and schedules declared per project, run only once you trust the folder.
Schedules and webhooks
Section titled “Schedules and webhooks”- Prompts on a cron schedule, once at a set time, or on demand, to a new agent, the same agent, or one exact conversation.
- A history of 1,000 runs. A failed or uncertain run stops its schedule until you check it.
- Webhooks: URLs that run a schedule when a service calls them.
People and machines
Section titled “People and machines”- Project machines: a project’s agents in a Docker or Podman container on a private clone.
- People: a Vendetta of their own on your computer, with their agents in containers.
- Sharing a whole container project with another person, with each prompt naming who sent it.
- The Claude proxy and git proxy, which serve your logins to machines through sockets without copying them in.
- Skills and MCP servers shared one by one.
Plugins
Section titled “Plugins”- These plugins ship:
messaging,hud,hud-kitty,host-tmux,host-kitty,shortcuts,speech,dictation,ntfy,webhooks,claude-proxy,github,personal-hub,dashboard,diff,tui, andtailscale. - The control protocol, version 1: agent tools, events, services a plugin serves, plugin schedules, and commands a plugin adds to
vendetta. - Plugin UI, version 1: contributions to slots and pages of nodes, drawn natively by the web client, the iPhone app, and the chooser.
- Changes: an agent’s committed work by revision, with diffs and the owner’s line comments.
Desktop
Section titled “Desktop”- A HUD of cards over your windows on Hyprland and macOS, with your own sections from any program that prints JSON, and a Kitty HUD.
- Dictation into the focused agent or window, with a Hyprland frontend and a macOS app.
- Alerts in the HUD, on the desktop, and through ntfy.
For agents
Section titled “For agents”- Three skills,
vendetta,vendetta-pages, andvendetta-alerts, that tell an agent what reaches its owner and how to send it.
Platforms
Section titled “Platforms”- Linux and macOS 13 or newer, built from source with
install.sh. - Licensed under AGPL-3.0.