Skip to content
Docs0.9GitHubInstall

GuidesAdd a family member

Add a family member and share a list

Give someone at home their own app, share one project with them, and keep a grocery list with an agent you both talk to.

This guide is for the person who runs Vendetta at home. You add a family member, who only ever sees the app, and shareShare. Giving another person on the same computer a whole container project. one project where an agent keeps a list for both of you.

The examples follow Peter, who runs Vendetta, and Ani. The project is groceries. Ani’s side is in You’ve been invited; send it to her.

If this is the first person you add, do Prepare the computer, once first.

In the app, open Settings, then People, and choose Add person: Name ani, Display name Ani. Or from a shell:

vendetta instance add ani --display-name "Ani"

Her phone needs to reach your computer on your tailnetTailnet. A private network between your own devices, made with Tailscale.Tailnet. A private network between your own devices, made with Tailscale.: invite her to it, or share the machine with her Tailscale account.

The last step shows Pair Ani: a QR code, a code, and a web address. On her iPhone, install the app from the TestFlight link on vendetta.sh/install and scan the code. On any other phone, open the web address and type the code.

Her app starts in Simple: her chats by project, a New Agent button, and nothing about models, managers, or schedules. She can leave it that way.

Choose New project, start from Empty, name it groceries, and choose Create. Or:

vendetta machine project add --new groceries

This makes an empty repository in ~/projects/groceries and a container for its agents: a container projectContainer project. A project whose agents run in a machine. Inside, Claude Code runs without asking for approvals, and the container is the boundary.Container project. A project whose agents run in a machine. Inside, Claude Code runs without asking for approvals, and the container is the boundary.. The first container builds its image, which takes a few minutes.

On the project’s screen choose Share (on iPhone, Share… in the project’s menu), pick Ani, and confirm. Or:

vendetta share project groceries --with ani

The project shows up in her app with your name on it.

Agents in a container get the vendetta skillSkill. Instructions an agent loads for one kind of task.Skill. Instructions an agent loads for one kind of task. and no other. The skill for writing pagesPage. A small HTML page an agent writes as its answer: a checklist, a comparison, a form.Page. A small HTML page an agent writes as its answer: a checklist, a comparison, a form. is yours to give them:

vendetta instance pick --machines --skill vendetta-pages

Then start an agent in groceries with New Agent and tell it what it is for:

Keep our grocery list in list.md. When either of us says what we need, update the
file and answer with a checklist page of what is still to buy.

Either of you opens the chat, holds the microphone, and talks:

We’re out of olive oil, and I need lemons for Saturday.

The agent gets the transcript with the speaker’s name in front, updates the list, and answers. Voice notes need transcription set up on your side; Ani’s go through yours, unless you turned Services off for her.

A photo works too. From Photos on an iPhone, share a picture of a recipe to Vendetta, pick the chat, and add “what are we missing for this?”.

The agent’s reply ends with a link, and the page opens inside the chat. Choose Pin to chat on the open page: it stays above the messages, and a chat holds up to ten pinned pages.

Ticks are saved on your side: close the page, open it on another of your own devices, and they are there.

A schedule can prompt the project on a time. In a container project each run starts a new agent, and its chat appears for everyone the project is shared with:

vendetta schedule add --id weekend-groceries --cron '0 17 * * 5' \
  --timezone Europe/Sofia --new --provider claude \
  --cwd ~/projects/groceries --tmux-session groceries \
  --prompt 'Read list.md, then ask us both: anything for the weekend?'

Its history and failures work as in A nightly job with run history.

An agent can ring your devices: “start a 20-minute oven timer” becomes vendetta timer 20m, which counts down in the chat and sounds with notifications muted.

This works for agents outside containers, such as your Master. An agent in a container project can’t ring anyone’s phone, so ask the Master for the timer. Ani’s agents all run in containers, so timers don’t reach her phone.

In the shared project she can prompt, answer the agent’s questions, send voice notes and photos, interrupt it, resume an ended conversation, and start another agent. Stopping, deleting, and renaming its agents stay with you, and so do its teams and schedules. The agents there never ask for approval: the container is the boundary.

In her own Vendetta she can make her own projects, up to the number you allow in [people] machines (5 by default). You see their names and can stop or remove them; you never see her chats.

When your computer is asleep or off, her app says Offline · tap to retry and a message she sends reads Offline. Not sent. Nothing is sent later by itself, so keep the computer on.

Open Share on the project and remove her, or vendetta share remove ID (IDs are in vendetta share list). The project’s chats leave her devices at once.

Remove on her row in People, or vendetta instance remove ani, lists what goes and asks you to type her name: her Vendetta, her own projects, her chats, and her paired devices.