You never have to learn the farm. Tell an agent, it sets it up.
You never have to learn the farm. Say it in a chat, and the agent looks up how, does it one call at a time and shows you each call. When you leave the desk the farm comes with you: a card on your phone, a tone from the next room, a voice that says which agent wants you.
Every session is told at its start how to reach the farm. So you say it in one sentence and the agent does it: it reads what the farm can do, then calls it, one command at a time. Each call shows up as a notification. Nothing is done behind your back.
showrunnerClaude Code · in the Console
Agent Farm bridge: run node "…/bridge/af.js" <op> [@args.json] from the shell — it is not an MCP tool, and every engine and account reaches it the same way.
The farm, meanwhileTasks · Plan
15 Never waits
Question cards · phone · Telegram · sound · voice
Away from the desk. Never in the way.
An agent with a question doesn't sit idle for hours. A countdown runs, and when it ends the recommended answer goes in. Permissions are different: they wait for you, ring, and reach your phone or a Telegram chat, where one tap answers. Every event has its own sound, and any answer can be read aloud.
developerClaudequestion0:12
Which export format should the timeline use?
Nobody at the desk? When the ring runs out, the recommended option goes in.
reviewerCodexpermissionwaiting 4m
Run git push origin main?
A tool permission is never answered for you. It waits, rings, and reaches your phone.
Question card · PulseAsking you · Intercom knockTurn finished · CrystalQuota running out · Thin ticks
● Now● WebDevices
Now
2 waiting · 3 running · $41.20 today
Waiting for you 2 ›
Running 3 ›
developerClaudeworking
scholarGeminiidle
reviewerCodexwaiting
Today
$41.20 spent today
developer · working ▾Say something…
AF
Agent Farmbot · bound to developer
Message➤
The farm on your phone, in three tabs: Now, Web and Devices.
ConsoleAgent Farm — SoundSettings
🔊 rings on 2 of 10 events · Quiet hours off · Mute all off
EventRingsToneSay who
Turn finished
Asking you
Stalled
Session ended
Error
New notice
Question card
Workflow asks you
Quota running out
Mission ended
Tone volume100
Also sent to🔗 Webhook · off
Your own soundsTen tones made for it, and room for ten of your own: any sound file a player on your machine can play. An event, an agent or one session can take any of them.
ReminderA question still unanswered after 3 minutes rings a lighter tone, up to twice. A finished turn needs nothing from you, so it never nags.
Quiet hoursA window that wraps midnight, 23:00 – 08:00 for example. Sounds only: the cards still arrive.
SessionsAgents3 live · 2 sound differentAll live ▾
Every session can sound like the rest (Like all), ring even when the fleet is quiet (Always), or never make a sound (Silent). It can take its own tones and its own voice, and have every answer read aloud as its turn ends. The Agents tab does the same for all of one agent's sessions.
Voice
Say whoAuto — match the answer's language ▾Speed
Sentence+ agent+ event+ session"developer, asking you"
Reading a message's 🔊, Read Last Answer, Read Selection, Read aloud and the daily briefing
VoiceAuto — match the text's language ▾Speed
LengthRead aloud reads the first part, then says there is more ▾
CodeSay its size — "a 3-line code block" ▾
developerClaudeturn 14 · its last answer
Press 🔊 to hear the whole answer, or select a few words and press Read selection. Code is said by its size, not read out character by character.
In the app the voice is your system's own, local and free: Windows speech, macOS say, Linux spd-say. A Turkish answer is read by a Turkish voice and an English one by an English voice. Here your browser reads it, with a voice on this device only, so the text goes nowhere.
VIII·1
Just ask
Say "make me a weekly video recipe" in a chat. The agent sets it up through the bridge; you never open a form.
A farm with hundreds of switches is one you would have to learn. Most people never will, and should not have to.
How it works · pick a step
The manual cannot drift from the farm: the build fails when an operation has no description, or when a guide names an argument the operation does not have.
Settings · 1
Setting
Default
What it does
agentFarm.agentManual.startCard
card
What a session is told when it starts: the whole card, one line, or nothing.
VIII·1One sentence1 / 5
VIII·2
579 operations
What you can do with a click, an agent can do with a call: a button with no operation fails the build. A few things stay yours on purpose: granting a tool permission, stopping a question's countdown, and a secret's value. New abilities show up in farm.ops by themselves.
If an agent can do only half of what you can, every request ends with "open the page yourself".
How it works · pick a step
The full catalog, farm.ops full=true, is large, so it is written to a file with --out and never read into a model's context. An agent can ask about itself too: sessions.whoami names the session it is, worked out from its own process tree, never guessed from the folder, where several sessions often run at once.
VIII·2Same as a click1 / 5
VIII·3
One command line
The bridge is a single shell command, so any agent that can run a command can use the farm. Gatekeeper also comes as an MCP server.
A tool only one kind of agent can call splits the fleet in two: the agents that can drive the farm and the ones that cannot.
How it works · pick a step
A call waits 20 seconds by default. If it times out, af.js says which: the farm took it and is still running, or nobody took it and nothing ran. With VS Code closed, the request waits for the next window.
VIII·3One command1 / 5
VIII·4
Agents with a home
Each agent keeps its own identity, duties that run every turn or session, and tools. The Toolbox shows every skill, subagent, command, MCP server, hook and plugin on the machine, adds new ones and tests what an MCP server really offers.
What it solves
An agent that is only a prompt forgets what it is for, and the standing agreements you made with it end up scattered in old chats.
How it works · pick a step
Duty templates set up the common ones in one pick: a question-and-answer loop, inbox triage, weekly memory upkeep, an output folder. A duty can be copied to another agent.
Settings · 4
Setting
Default
What it does
agentFarm.agentRoots
[]
The folders scanned for agents. It starts empty: you add your own.
agentFarm.newAgentModel
sonnet
The model a new agent starts with.
agentFarm.contextBudgetTokens
8000
How many tokens an agent's fixed files may load.
agentFarm.excludeAgentDirs
[]
Folders never treated as agents, even when they look like one.
VIII·4Its own folder1 / 5
VIII·5
Capability Matrix
Which agent has which skill, MCP server and memory file, and which of them were actually used in 30 days.
What it solves
With ten agents nobody remembers which one has which skill, which MCP server is dead weight, or which copy of a memory file is the new one.
How it works · pick a step
Use is counted from the agents' own session logs, so it is what they did, not what their settings say.
VIII·5Who has what1 / 5
VIII·6
Phone app
Answer, approve with a button and watch the fleet from your pocket in the Agent Farm phone app, paired by a QR code; it can even wake a closed VS Code. Or a read-only web page on any device you allow.
The moment you leave the desk, a question waits unseen, and the run behind it stands still until you are back.
How it works · pick a step
The app talks to your own machine on port 7443, nothing goes through a server of ours. Its scopes are read, answer, manage and admin; a phone pairs at manage.
Settings · 2
Setting
Default
What it does
agentFarm.web.enabled
off
The read-only web page.
agentFarm.web.port
8378
The port it answers on.
VIII·6Pair it1 / 5
VIII·7
Telegram
A Telegram chat talks to your agents. A card arrives when a turn ends or asks, and one tap answers it. Only the chats you allow, within a daily budget.
A turn that ends while you are out should reach you where you already are, and your reply should reach the agent.
How it works · pick a step
The budget counts every turn of a session started from the chat, wherever the turn was typed. Notifications can also go to a webhook of your own: permissions, stalls, budgets, a workflow done or failed, the weekly summary, and once a day a scorecard of the cost, the agents, the top spenders and the warnings, made without calling a model.
Settings · 5
Setting
Default
What it does
agentFarm.telegram.allowedChats
[]
The chats it listens to. Empty, every message is refused.
agentFarm.telegram.maxDailyUSD
$1
What turns started from Telegram may spend in a day.
agentFarm.telegram.whenBusy
queue
A message sent during a turn: wait for it to end, or steer it.
agentFarm.notifyWebhookUrl
empty
A webhook of your own that notifications are passed on to, such as n8n into a chat.
agentFarm.dailyDigest
off
A time such as 21:30 to send the day's scorecard to that webhook.
VIII·7Connect1 / 5
VIII·8
Sound
A tone for every event, for one agent or for one session: ten made for it and room for ten of your own, with quiet hours and a reminder for an unanswered question.
An agent you have tuned for months lives in one folder on one machine. Setting it up again on a laptop, or sharing it, means copying by hand and hoping nothing private comes along.
How it works · pick a step
An agent can pack itself too, over the bridge, by the same rules.
Settings · 1
Setting
Default
What it does
agentFarm.packGalleryRepos
[]
Where the pack gallery looks: git addresses or local folders.
VIII·10One file1 / 5
Questions
Can an agent approve its own permissions?
No. An agent can answer a question through the bridge, but granting a tool permission stays with you: in the panel, on your phone or in Telegram. Only you can stop a question's countdown, too.
Do I have to learn the bridge?
No. Every session is told at its start how to reach the farm, and an agent looks up the rest in the farm's own manual. You say what you want; each call it makes shows as a notification.
Does the bridge work with VS Code closed?
The manual answers at once. Anything that changes the farm waits for the next VS Code window; af.js gives up after 20 seconds and tells you whether anything ran.
Can strangers write to my agents on Telegram?
Only the chats on your list are heard; with an empty list, every message is refused. Turns started there have a daily budget, $1 out of the box, and a risky-looking command asks before it runs.
What does a phone wake-up send through Google?
Only that there is something new, and which farm. The phone then reads the rest straight from your machine over its own encrypted connection.
What does an agent pack leave out?
Its memory and its secrets, files that look like credentials, and webhook tokens. The triggers and schedules in it arrive switched off.