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.
Set it up
Section titled “Set it up”Add Ani
Section titled “Add Ani”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.
Create the project
Section titled “Create the project”Choose New project, start from Empty, name it groceries, and choose
Create. Or:
vendetta machine project add --new groceriesThis 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.
Share it with Ani
Section titled “Share it with Ani”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 aniThe project shows up in her app with your name on it.
Give the agent its job
Section titled “Give the agent its job”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-pagesThen 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.Add to the list by voice
Section titled “Add to the list by voice”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?”.
Use the checklist page
Section titled “Use the checklist page”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.
Ask every Friday
Section titled “Ask every Friday”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.
Set a kitchen timer
Section titled “Set a kitchen timer”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.
What Ani can and can’t do
Section titled “What Ani can and can’t do”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.
Stop sharing, or remove her
Section titled “Stop sharing, or remove her”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.