Neoo, the global chat
Write everything in one place. Neoo answers small questions itself and sends real work to a Bot — the one that follows the topic, a new Bot for the project it belongs to, or a background work.
Neoo is your main assistant. Instead of choosing a Bot before you write, you write to Neoo, and it decides where the message goes. Neoo is a front desk: real work is always done by a Bot.
- It answers itself only for greetings and quick questions that need no tool, file or project knowledge.
- It passes the message to an existing Bot when the message belongs to a topic that Bot follows (a project, a client, a domain such as suggestions). The Bot can run on this computer, on Neoo Cloud or on another computer of your account.
- It offers to create a Bot when no Bot follows the work yet: for a project you already work on in a folder, or for a new topic that will last. Nothing is created until you click.
- It asks which project when the message is work for one of your projects but nothing says which one. You answer with one click.
- It starts a background work for a one-off task that belongs to no Bot and no project. The work gets its own conversation and a card in Neoo's chat (see background works).
A Bot follows one topic over time. A one-off task is never a new Bot: it is a background work of the Bot of the topic, or of Neoo. For example, handling 40 suggestions at once is one "Suggestions" Bot running 40 works, not 40 Bots.
Neoo is available with the Minimal interface style (Settings → Appearance → Interface style). Click Ask Neoo (the bar with a speech bubble) at the top of the left column. The first time, Neoo is created on this computer, as a Bot that does not appear in the list of topics.
Neoo is global to this computer: it does not belong to a project. It works from your personal folder, and the folder that happens to be open in the app plays no part in where your message goes.
When the app reloads or restarts (an update, a crash, or a code change while you run Neoo from source), it reopens where you were: Neoo's chat, a Bot's chat or the background work you had open, with the text and images you had not sent yet still in the message box. A Neoo or Bot of another computer is waited for a few seconds while that computer sends its list.
Your other computers
Ask Neoo is the single place to write, whichever computer does the work. Each computer of your account has its own Neoo, but you do not have to switch between them: the Neoo of the computer in front of you also reaches the Bots and the projects of your other computers.
- Bots on another computer. Neoo passes a message to a Bot that runs on another computer of your account, exactly as it does for a Bot on this computer or on Neoo Cloud. While it sends, it names the machine: Handing it to {Bot}, on {computer}…. The request becomes a background work of that Bot, on its computer.
- Projects on another computer. Neoo also knows the projects of your other computers (see Which project a message is for). A message for such a project goes to the Bot that follows it on that computer. When no Bot follows it yet, Neoo offers to create one on that computer, in the folder of the project.
- A task on the other computer itself. The Neoo of each other computer is listed among the Bots you can write to, as Neoo · {computer}. A one-off task that must run on that machine ("on Studio, empty the Downloads folder") goes there when your message names the computer, or when you start it with
@Neoo {computer}. It runs as a background work of that Neoo.
When the other computer is off. A computer that is switched off or disconnected does not wake up. Nothing is sent: Neoo shows {computer} is off: {Bot} did not get your request. Turn it on or open Neoo on it, then send it again., and your message is back in the message box (or kept in the conversation with Take the message back). The Bots and projects of that computer stay known from the last state it sent, so the request is not sent somewhere else by mistake.
What is needed. Bots of another computer are reachable as soon as that computer has been online since you opened Neoo. Its projects and the creation of a Bot there need Neoo up to date on both computers. A project that exists on this computer too (same folder name) is handled here.
Reading the Neoo of another computer
The Neoo of another computer is never listed among your topics. To read its conversation, open … at the top right of Neoo's chat (Neoo chat actions), then Neoo's computer, and choose the computer. Offline under a name means that computer is switched off or disconnected: you see the last state it sent.
While you read the Neoo of another computer, the header shows its name between Neoo and the works, and the computer button at the bottom left of the message box shows it too. Click either one and choose This computer to come back. In the Neoo of another computer, your messages go straight to that Neoo: this computer does not decide where they go, so there is no hand-off to a Bot, no Bot proposal and no project question. Reset the conversation and History are only available in the Neoo of this computer.
Ask Neoo always opens the Neoo of this computer. Neoo does not move from one computer to another: its chat never shows where a Bot runs or lets you move it. When no other computer has a Neoo, Neoo's computer is not in the menu.
Starting over, and the history
Neoo's chat is not a Bot you set up: its header has no profile and no Bot actions. The … button at the top right (or a right click on the header) opens the Neoo chat actions:
- Reset the conversation clears Neoo's conversation and lets Neoo start again without the previous exchange in mind. Click it, then click Confirm: clear this conversation. The conversation you clear is kept in the history. Your Bots and Neoo's background works are not affected.
- History lists the conversations you cleared, with their date and number of messages. Choose one to put it back; the conversation that was on screen is saved in the history in turn.
Both actions are unavailable while Neoo is answering or deciding where a message goes. A conversation that only contains cards of background works, with no message of yours, is cleared without being saved.
The welcome screen
While Neoo's conversation is empty, or when everything in it is settled (see What the conversation shows), the message box sits in the middle of the screen, under a greeting (Good morning., Good afternoon. or Good evening., then What are we working on?) and one sentence that sums up what Neoo does with a request.
Under the message box, Write directly to lists up to six of your Bots, those of your other computers included. Click one to put @{Bot name} in the message box: the message then goes to that Bot without Neoo deciding. You can also type it yourself, for example @Suggestions handle #2471.
As soon as you send a first message, the message box moves back to the bottom and the conversation starts.
Where your message went
Your message appears in the conversation as soon as you send it, and Neoo answers right under it:
- Going over your Bots and projects…, then Looking for who should take this… while it decides. A row of your Bots is shown under the text, ending with a dotted circle that stands for a new Bot. This takes a few seconds.
- Handing it to {Bot}… while the message is sent to a Bot, or Handing it to {Bot}, on {computer}… when that Bot runs on another computer of your account.
- Starting a background work… when the request is a one-off task that belongs to no Bot and no project. Your message then stays in the conversation, followed by the work's chip, {title} · started in the background. Hover the chip to see where the work runs: the project folder, or no project when it runs from your personal folder. While it runs, the work has a row in the dock above the message box (see Conversation and background works).
- A receipt in the conversation once the request is with that Bot: one line with the Bot's avatar and name, then what happened. Sent · Work "{title}" when your request became a new background work of the Bot, Sent · Added to the work "{title}" when it continues a work the Bot already has (see below), Sent · In its conversation when the Bot cannot run background works. While the work is in the Bot's list, the line also shows its state: Working, Waiting for your answer, then how it ended: Finished (in green), Failed (in red) or Stopped (when it was stopped before the end). The Bot's avatar on the line moves only while that work runs: once it is finished, the avatar stays still even if the Bot is busy with another work. Click the line to open the Bot on that work.
- When the work ends, the receipt becomes its summary: under the line, one or two lines taken from the work's report, its opening sentence and, when the report has one, what is left for you to do ("Not verified: …", "Still to do: …"). Neoo adds no new message to the conversation and calls no model for this: the text is cut from the report itself. A work that failed or was stopped without a report shows only its state.
- While the work is still in For you (in the Minimal style), the receipt shows Settle: click it to remove the work from For you without opening it. See Settings, Minimal style.
- When a work ends while its receipt is out of view, a short line appears just above the message box: {Bot} finished · See the summary (or {Bot} failed, {Bot} stopped, 2 works finished for several). Click it to scroll back to the receipt. The line goes away once the receipt is back in view. It only appears while the conversation is open; after a restart, the receipts still carry their summary.
- Under the latest receipt, Wrong Bot lets you choose another Bot, or Let Neoo answer. The first Bot keeps the message it already received. The × hides this line.
Receipts stay in Neoo's conversation, one per request it passed on. A Bot Neoo created for your request shows Bot created · Work "{title}": your request is the Bot's first background work, and the receipt follows it like any other (state, summary, Settle). Receipts written before that change did not name the work; they are linked to the Bot's first work when it started within 10 minutes before the receipt. A receipt that still does not know its work (the Bot was created on another computer that is not up to date) shows Bot created · request sent, without a state. Notes written by earlier versions ("→ Sent to Suggestions.") are shown as receipts too.
Files attached to your message (a screenshot, a document) are shown above it and go with it: to the Bot that receives the message, to the Bot Neoo creates, or to the background work. For a Bot that runs on Neoo Cloud or on another computer, the files are first sent to that machine. Neoo decides where the message goes from its text; it does not read the attached files.
You do not have to wait for a message to be handed over before sending the next one. There is no queue: each message you send appears right away, with its own status line under it (Looking for who should take this…, Handing it to {Bot}…), and Neoo handles them at the same time. Each one gets its receipt as soon as its Bot has it, so a quick request can be passed on before an earlier one that takes longer. A question (Which project is this for?) or a Bot proposal stays under the message it belongs to until you answer it. Wrong Bot only shows under the latest receipt.
If Neoo cannot pass a message on, it shows Neoo could not pass it on: followed by the reason. When the Bot runs on another computer that is off, it names the computer to turn on instead (see Your other computers). When Neoo could not decide where the message goes, the message is back in the message box, unless you are already writing the next one: it then stays in the conversation under the error. When it failed later (creating the Bot, or sending after you chose a project), the message stays visible in the conversation. Click Take the message back to put it in the message box again; if the box already holds text, the message is added after it.
Answering a Bot's question without leaving Neoo
When a Bot that received one of your requests needs you, you do not have to open it. Its request appears in a card right above the message box of Neoo's chat.
One request at a time, the oldest first. The card shows the Bot's avatar and name, then the title of the work that asks. When several Bots or works are waiting, the other requests are stacked behind the card: the top of each one sticks out with the name of the Bot that asks (two at most). The header shows where you are, for example 1 of 3.
- A question is shown in full: pick an option, or choose Other to type your answer. It goes straight to the work that asked (or to the Bot's conversation), which carries on. The oldest request left then comes to the front. Skip declines the question. A question with a time limit shows Expires in {time}.
- A permission, a connection or a secret shows A request is waiting for you: it is answered inside the Bot, and Answer opens the Bot on that work.
- Open opens the Bot on the work that asks, to read what it did before you answer.
- To answer in another order, click a request stacked behind the card: it comes to the front, and the one you were looking at goes back into the stack. The arrows next to 1 of 3 (Previous request, Next request) do the same, one step at a time.
The card covers what Neoo's conversation passed on: the works named on its receipts, and the conversation of a Bot that received your request directly (Sent · In its conversation, or Bot created · request sent when the receipt does not know the work). A work you started yourself in a Bot's own conversation asks its question there, and in For you.
Limits:
- Only Bots that run on this computer. For a Bot on Neoo Cloud or on another computer, the receipt says Waiting for your answer: click it to open the Bot and answer there.
- The Neoo of another computer, the mobile app and vatoide.com do not show this card.
What the conversation shows
Neoo's chat is where you follow your works, not a full transcript. It shows:
- every request whose work is running, waiting for your answer, or finished but not settled yet, with your message and its receipt. A finished work stays until you click Settle, on its receipt or in For you; after 3 days it settles by itself. A work that finished while you were watching it never enters For you, so it is folded as soon as it ends, like a settled one;
- your latest exchange with Neoo, whatever it is (a quick answer, a question about which project, a message being handed over), and any turn still running.
Everything else is folded: requests whose work is settled (even the latest one: Settle on a receipt removes it from the conversation), Neoo's earlier short answers, and background works of Neoo itself once they are finished. A work you archived (Archive in the work's menu) counts as settled: its receipt keeps its outcome (Finished, with the summary) and is folded with the finished ones. A request whose work this screen does not know (it has just started, its computer is off, or the work was deleted) stays visible for 3 days, without a status.
At the top of the conversation, Show finished · {count} brings the folded requests back, each at its place in the conversation; the view stays where it was, as with "load more". It then reads Hide finished. While the conversation is folded, older pages of the history are part of the finished ones: Earlier messages appears once you have clicked Show finished. Opening a Bot or a work and coming back to Neoo folds the conversation again.
When nothing is running or waiting to be settled, the welcome screen comes back, with Show finished at the top of the screen.
Nothing is deleted: Reset the conversation, History and Continue from this message work on the whole conversation, folded parts included. This applies to the Neoo of this computer; the Neoo of another computer and the conversations of your Bots always show everything.
Sending a message again
To send a request again, for example when it went to the wrong place:
- Edit it. Click your message, change the text if needed and send it. The message and everything after it are removed from Neoo's conversation, and the new text is handled like a new message: Neoo decides again where it goes. Its attached files stay with it.
- Continue from this message. Hover your message, open More actions and choose Continue from this message. Everything after that message is removed (Neoo's answer, the receipts of the requests it passed on), Neoo forgets that part of the conversation, and the message opens for editing. Send it to let Neoo decide again.
What was removed stays available in Chat restore points (the round arrow at the top right of the conversation). A message that was already passed to a Bot stays in that Bot's conversation.
Which project a message is for
Most messages do not name their project ("go check", "release a new version", "why is it stuck?"). Neoo finds it from what the folder used to tell:
- The project you name. When your message names one of your projects, the message is for that project, even when the name is typed or dictated slightly differently ("vato ID" for the folder
vato-ide). This applies to folder names made of several words; a one-word folder name such astestis too common to count. A named project wins over the clues below. - Past conversations that look like the message, and the projects you worked in last.
- The words of your message. When a word of your message comes back in the titles of several past conversations of one project, and rarely elsewhere, it points to that project. For example, "put the new GPT models in production" goes to the project where your conversations about models are, even if nothing names it.
Neoo reads these clues from the conversations of this computer and of this app. A separate installation (for example a development build) has its own history, and counts as another computer of your account.
Projects of your other computers. Neoo asks each other computer of your account that is online for its projects: their folder name, the words that come back most often in the titles of its conversations, and its three latest titles, never the content of conversations. It keeps that list for ten minutes, and keeps the last one when the computer goes offline. Up to six such projects are considered, the ones with the most conversations first. A message goes to one of them when it names it or when its words match it; the two clues above (similar past conversations, latest projects) only come from this computer. In lists and on cards, a project of another computer is shown with its machine: {folder name} · {computer}.
When this is not enough, Neoo does not guess. Under your message, it asks Which project is this for? with up to three of your projects:
- Click a project: the message goes to the Bot that follows that project, or Neoo offers to create one (see below).
- Another project lists your other known projects.
- No project starts a background work without a project.
- The × closes the question without sending anything.
A project is a folder where you had at least two conversations in the last 60 days. A folder that only contains other projects (for example the folder holding all your repositories) is not a project: what you ask there is treated as a one-off task.
Which Bot follows a project. A project's messages go directly to a Bot only when that Bot follows the whole project: a Bot Neoo created for the project (its name is {folder name} operations by default), on this computer. A Bot that merely works in the project's folder keeps its own subject: a Bot for your company's finances or for monthly invoices, created while that folder was open, does not receive the other work of the project. A Bot on Neoo Cloud or on another computer is never the Bot of a folder of this computer. For such a project, Neoo offers to create its Bot. For a project of another computer, the Bot that follows it is the one that computer names: a Bot its own Neoo created for the project.
Neoo reads each Bot's mission from its role and, when the role is empty, from the beginning of its instructions.
One work per request
A request that Neoo passes to a Bot becomes a background work of that Bot, not one more message in its conversation. The Bot's conversation shows the card of the work, then its report when it finishes; open the work to see the detail. Two different requests sent one after the other are two works, even for the same project and even while the first one is still running.
When the Bot already has works, Neoo checks whether your message is a clear follow-up of one of them (an answer, a correction, one more detail, a question about its result). If so, the message is added to that work, and waits for the current turn to finish when the work is running. Another subject, another ticket or another number always starts a new work. When Neoo is unsure, it starts a new work.
A message you write directly in a Bot's conversation is not changed by this: it goes to that conversation. Use /new or Run in background there to start a work yourself.
Neoo's own chat on the desktop has no Run in background button, and Alt+Enter sends the message like Enter: a message sent from this chat always goes through Neoo, which looks for the Bot that should take it. To start a work of Neoo itself on purpose, without a Bot, type /new followed by the task.
A Bot on a Neoo Cloud machine that has not been updated yet cannot run background works: it receives the request in its conversation.
What the Bot receives
The Bot receives your message as you wrote it, with its attached files. When the Bot is attached to a project, Neoo adds a note that only the Bot sees: the titles of up to five past conversations of that project about the same topic, and the instruction to read them before acting and not to ask you again what they already say. The note is not shown in the Bot's conversation. It is not added for a Bot that runs on Neoo Cloud or on another computer.
Creating a Bot for a new topic
When no Bot follows the work, Neoo says so under your message and shows a card with a suggested name and mission (for a project, the name and mission of the project, not of the request of the moment, because the Bot will follow the whole project): No Bot follows this project yet. Shall I create one? when the message belongs to a project you already work on, No Bot follows this topic yet. Shall I create one? otherwise.
For a known project, the card shows Project: {folder name} (hover it to see the full path). If Neoo picked the wrong project, click Project: {folder name} and choose another of your projects: the card switches to that project, or, when a Bot already follows it, your message goes to that Bot. A card without a project shows No project, which you can click in the same way to attach the Bot to a project. The Bot is created in that folder: it works there, and finds the memories and past conversations of the project. Its instructions tell it to look up what was already done before acting, and to work end to end on its own.
- Change the name if you want (click it in the card and type), then click Create and send. While the Bot is being created, Neoo shows Creating the Bot {name}…. The Bot is created on this computer with this mission, and your message becomes its first background work. A receipt Bot created · Work "{title}" stays in Neoo's conversation and follows that work: Working, Finished with the summary, Settle.
- For a project of another computer, the card shows Project: {folder name} · on {computer} and Neoo shows Creating the Bot {name} on {computer}…. The Bot is created on that computer, in the folder of the project, and receives your message and its attached files there. If a Bot already follows the project by the time you click, your message goes to that Bot and no second Bot is created.
- Let Neoo answer keeps the message with Neoo, and no Bot is created.
- The × closes the card without sending anything.
The new Bot appears in the list of topics. You can then move it to Neoo Cloud, rename it or give it skills like any other Bot.
A Bot for work you repeat
When you open Neoo's chat, it looks at the titles of your conversations of the last 60 days. If the same kind of numbered item comes back in at least 8 conversations (for example "Suggestion #2469", "Suggestion #2471"…), and no Bot handles it yet, Neoo shows a one-line suggestion: the name of the Bot it would create, then Suggestion · {count} "{word}" conversations in {days} days and the project concerned.
On the empty conversation, the line sits under the message box, below Write directly to. Once the conversation has messages, it sits at the end of the thread. It is not shown again once you have sent a message, until you reopen Neoo's chat.
- Create the Bot creates it in the folder of the project where this work comes back most often, with a mission to handle these items from their number. Click the name on the line to change it first.
- If you used to open these conversations with the same slash command (for example
/suggestions cloudbizz · #2473), that command becomes the Bot's method: Neoo copies its text into the Bot's instructions, and the Bot treats every request as if you had typed the command before it. The Bot keeps the command's stopping points: when the command says to ask you something (for example "Fix it or leave it as is?"), the Bot asks and waits for your answer. The command counts when it opens at least 3 of these conversations and at least one in five. If Neoo cannot find the command's file, the Bot gets its name and looks for it itself. The new Bot then writes the first message of its own conversation: it greets you, says what it is there for and suggests a few first requests. A receipt Bot created stays in Neoo's conversation; write@{Bot name}followed by your request to talk to it from Neoo's chat. - The × (Don't suggest again) dismisses this proposal for good.
Bots that are no longer used
When a Bot that Neoo created has not been used for 30 days, Neoo shows "{Bot}" has not been used for 30 days.:
- Hide removes it from the list of topics. Nothing is deleted: hidden Bots stay available in More → All Bots.
- Keep keeps it, and Neoo will not ask again.
Bots you created yourself are never proposed.
How Neoo decides, and what it costs
Neoo itself runs on a light model by default: Haiku 5.5 with a Claude account, GPT-6 Sol with a Codex account (with other providers, your default model for new Bots). You can change it with the model selector of Neoo's message box, like for any Bot; your choice is kept. Bots that Neoo creates use your default model for new Bots, not Neoo's. A background work that Neoo starts runs on the model you use most often with that provider (counted over your conversations of the last 60 days), not on Neoo's light model.
To choose where a message goes, Neoo asks the same models (Claude Haiku 5.5 with a Claude account, GPT-6 Sol with a Codex account; with other providers, the model of the Neoo conversation) on the account of the Neoo conversation. It only sends your message, one line per Bot (its name, mission and attached project), one line per project (the folder name, the words that come back most often in the titles of its conversations, and its three latest titles) for up to 12 projects of this computer and up to 6 of your other computers, the titles of your six most recently active conversations and of up to five past conversations that look like your message, and, for up to six words of your message, the number of past conversation titles of each project that contain the word — never the content of conversations. If the model is unreachable, too slow (more than 25 seconds) or out of quota, Neoo simply answers itself.
Short messages ("thanks", "ok") and messages starting with @Bot are handled without calling the model. A short message with an attached file is not answered by Neoo itself: it is treated as work. A message that starts with a command (/ship) is always treated as work, never answered by Neoo.