StartWords Vendetta uses
Words Vendetta uses
Every term the product and these docs use, with one or two lines each.
Each word below has one meaning everywhere in Vendetta: the terminal, the apps, the bots, and these pages. Other pages link here from a word with a dotted underline.
Agents and their states
Section titled “Agents and their states”Agent. One running session of a provider, such as Claude Code or Codex. Vendetta identifies it by its process, so a terminal pane is only where it shows.
Provider. The program an agent runs: Claude Code, Codex, omp, OpenCode, Gemini CLI, or Aider. You install and log in to each yourself.
Integration. The small piece Vendetta installs into a provider (hooks, an extension, Claude’s Mod) so the agent reports its state. Without one, an agent is listed with an unknown state.
Conversation. One provider session and its history. It outlives the process: an ended conversation can be restored.
Transcript. The provider’s own record of a conversation, kept in the provider’s folder on your computer. The apps read a chat’s history from it.
Chat. A conversation as the apps show it: messages, the agent’s replies, its state, and what it asks.
State. What an agent needs right now: working, a question, an approval, ready, unknown, or exited.
Turn. One stretch of an agent’s work, from a prompt to its final reply.
Final reply. The last response of a turn. It is the one that notifies you, and files an agent links in it are attached to the chat.
In-between response. What an agent writes during a turn before its final reply. The apps can fold these into one row.
Question. A choice an agent asks through its own question tool. It reaches you as buttons. Claude Code, omp, and OpenCode have such a tool.
Approval. A provider’s permission dialog for a tool call. Only you answer one: at the terminal, or for Claude Code in the iPhone and web apps with Allow once or Deny. Agents Vendetta starts on your computer ask before they run commands; agents in a container project don’t ask.
Launch arguments. The arguments and environment Vendetta starts a provider with, set per provider
under [harnesses.PROVIDER] in the config. They decide whether a managed agent asks
for approvals.
Subagent. An agent a Claude Code session starts inside itself. Its permission dialogs are answered at the terminal.
Interrupt. Ending an agent’s current turn, as Esc does in its terminal. The agent keeps running.
Managed agent. An agent Vendetta started, in its project’s Agents tab. Agents you start by hand are listed too and stay where you started them.
Ephemeral chat. A chat that is stopped and deleted once it has been idle for a while, 30 minutes by default.
Kept. A conversation marked so auto-delete never removes it.
Muted. An agent whose turns, questions, and approvals notify nobody. Its own alerts and timers still sound. Agents a manager starts begin muted.
Owner. The person an agent works for: whoever’s Vendetta the agent runs under. The agent skills, the bots, and the protocol pages use this word.
Places you look
Section titled “Places you look”Worker. The background process everything talks to, one per user. Start it with
vendetta notify start.
Scheduler. The process that runs schedules at their time. install.sh sets it to run at login.
Chooser. The screen in your terminal that lists projects and agents and jumps to any of them:
vendetta tui, or Alts in tmux once you bind it.
Jump hint. The letters beside a row in the chooser. Type them and press Enter to go to that pane.
Preview. The chooser’s panel that mirrors the selected agent’s terminal live. You can type into it.
Overview. The dashboard of four lanes: Needs you, Working, Ready, and Ended today. Each agent is a card in one lane. It is in the chooser (w), the web client, and the iPhone app.
Web client. The browser app, served by your own machine on the app port.
App endpoint. The private address your devices connect to. It listens on loopback until you publish it. The pages for developers also call it the app transport.
Pairing. Connecting one device with a one-time pairing code. Each browser and phone is its own paired device, and you can revoke any of them.
Simple and Advanced. Two levels of the apps. Simple shows chats and little else; Advanced adds the rest.
Jump mode. In the web client, a key that puts a letter on every screen, chat, and button, so you can go there from the keyboard.
HUD. Cards over your desktop windows that list agents, tasks, and alerts without taking the keyboard.
Tab labels. Agent states shown in the names of tmux tabs.
Project. A group of agents that work in one place, usually a git repository. With tmux, a project is a tmux session.
Agents tab. The pinned tmux window in each project where managed agents run.
Topic. A conversation’s thread in Telegram; on Discord it is a channel. The app protocol also calls each chat a topic.
History. The list of recent activity and exited conversations, kept for seven days.
Restore. Bringing back one exact ended conversation: Enter in the chooser’s history, or a new message in its chat or topic.
Terminal snapshot. An agent’s screen copied as text at one moment. Providers whose transcripts Vendetta doesn’t read reply this way, and View terminal in the apps shows one, with Refresh for a new one.
Agents that lead agents
Section titled “Agents that lead agents”Master. One trusted agent that lists, reads, prompts, and answers the others for you through
vendetta agent. It is optional, and it never answers an approval.
Manager. A Master for part of the work, usually one project: an agent with a team beneath it.
Team. The agents a manager leads. Teams nest, and an agent may have several managers.
Member. An agent in a team. Its finished turns and questions go to its managers, who tell you what matters.
Sub-manager. A manager that is itself a member of another manager’s team.
Adopt. A manager taking agents that already run into its team, with vendetta agent adopt.
Brief. A manager’s or declared agent’s first prompt: what it is for and who is in its team.
Work for later
Section titled “Work for later”Schedule. A prompt sent on a cron time, once at a set time, or on demand. Each run starts a new agent, goes to the same agent, or targets one exact conversation.
Run. One occurrence of a schedule. Every run is recorded, and a failed or uncertain one stops its schedule until you check it.
Webhook. A URL that runs a schedule when another service calls it.
Project file. A vendetta.toml at a project’s root that declares agents that always run, their
teams, and schedules.
Declared agent. An agent a project file names. Vendetta starts it and resumes it whenever it exits.
Trust. Your approval of a folder’s project file. Nothing in the file runs before it.
Task. A personal to-do from a plugin that serves tasks, such as the Personal Hub.
What agents send you
Section titled “What agents send you”Page. A small HTML page an agent writes as its answer: a checklist, a comparison, a form. It opens inside the chat, can send your choices back, and keeps its state. In a shared project each person’s copy keeps its own state.
Pinned page. A page kept above a chat’s messages. A chat holds up to ten.
Change. An agent’s committed work on one branch, shown with its revisions and diffs so you can read and comment on it.
Mark. A note you attach to a place: a box on a photo, a frame or a segment of a video, a moment in an audio file, a line of a change. The agent gets your marks numbered.
Track. A timed text file an agent attaches to a video: its narration, its on-screen text, or its subtitles.
Cue. One timed line of a track. You can suggest new wording for a cue as a mark.
Working line. The line above the message box while an agent works: how long the turn has run, the tool call running now, and the plan’s current step.
Plan. An agent’s own todo list, kept live. It shows on the working line, in the chat, and on the agent’s overview card.
Usage. How much of a provider’s plan limits is used, per window such as weekly and 5-hour.
Alert and timer. A sound an agent sets off on your devices, now or after a countdown. It is heard with notifications muted.
Live Activity. An agent’s status on the iPhone lock screen.
Push. A notification that reaches a device while its app is closed: through Apple’s service on an iPhone, and through Web Push in a browser.
Skill. Instructions an agent loads for one kind of task. Vendetta installs three,
vendetta, vendetta-pages, and vendetta-alerts, which tell agents what reaches
you and how to send it.
Voice and messages
Section titled “Voice and messages”Voice note. A recording you send as a prompt. It reaches the agent as its transcript. A note longer than 15 minutes, the default limit, is cut there and its first part sent.
Listen. Having one reply read aloud in the apps.
Voice mode. A hands-free conversation with one agent in the apps: it sends what you say when you pause, reads the reply aloud, and listens again.
Talk to Master. Voice mode with the Master’s chat, started from any screen.
Dictation. Speaking at your desk into the focused agent or window, through a desktop key.
Queue. Messages you line up for after the agent’s current turn.
People and containers
Section titled “People and containers”Admin. The person who installed Vendetta and runs it. People are added under the admin’s account.
Person. Someone the admin adds. They get a Vendetta of their own on the same computer, with their own chats and paired devices. The command line calls this an instance.
Machine. One container that runs a project’s agents on a private clone of the project. Also written project machine.
Container project. A project whose agents run in a machine. Inside, Claude Code runs without asking for approvals, and the container is the boundary. Machines run Claude Code only, and a container project has no Master inside it.
Claude proxy. The plugin that serves the admin’s Claude login to machines through a socket, so no token is ever inside a container. Its git proxy does the same for git logins.
The pieces underneath
Section titled “The pieces underneath”Host. A terminal Vendetta can read, type into, and launch in: tmux or Kitty. Agents outside every host are still listed. “On the host” has a second, plain meaning in these pages: on your computer itself, outside any container.
Plugin. A separate program the worker starts and supervises. Messaging, the HUD, dictation, tmux, and the overview are plugins, and you can write your own in any language.
Control socket. The worker’s private Unix socket. The chooser, plugins, and vendetta commands
reach the worker through it.
Service. Methods a plugin serves through the worker, called with vendetta service call.
Slot. A place in the apps that takes a plugin’s entries, such as the sidebar or a chat’s menu.
Tailnet. A private network between your own devices, made with Tailscale. It is the documented way to reach your machine from a phone.