Settings

A map of every Settings section in Neoo Desktop and what each one controls.

Settings gathers everything you can configure in Neoo Desktop, from the theme to your AI accounts.

Open Settings

  • Click the gear icon in the main navigation bar.
  • Or press ⌘, on macOS or Ctrl+, on Windows.
  • Or open the command palette and choose Settings.

The sections are listed on the left. Type a word such as "theme" in Search settings to filter them by name and description. Click Back to return to your work.

Application

SectionWhat it controls
GeneralHow Neoo starts, how agents behave and which local permissions they have.
AppearanceThe theme, the navigation and the surfaces visible in your workspace.
NotificationsThe events Neoo tells you about, and on which devices.
ShortcutsThe keyboard shortcuts. You can review and change each one.

In General you will find, among others:

  • Interface language, for the Neoo interface.
  • AI response language, for the answers of Claude, Codex and OpenRouter.
  • Default agent execution mode: Plan, Default permissions, Approve for me or Full access for new conversations.
  • Messages during a turn: whether Enter sends a follow-up to the Queue or uses it to Steer the running turn.
  • Live workspace (Beta, off by default): opens the workspace next to the conversation while the agent writes files, creates folders, runs commands or uses the browser. See Live workspace.
  • Agent collaboration and Question answer window, which control how often agents ask you questions and how long an agent keeps its turn open while it waits for your answer (the question itself stays open after that).
  • Commit attribution, the signature added to commits and pull requests created by agents: Neoo IDE (a Co-Authored-By: Neoo IDE trailer and a "Generated with Neoo IDE" footer), the provider's own credit, or none.
  • History carried over on a switch, how much of a conversation Neoo gives a new provider or account. See Models.
  • After a usage limit, whether Neoo asks you or resumes by itself when a provider limit resets. See Queue, usage limits and agents working together.
  • Final answer, the length and presentation of agents' final answers.
  • Conversation in the window title (on by default): the window title becomes "conversation — project · Neoo IDE". Neoo does not draw this title in its own window; the taskbar, Alt+Tab and time trackers such as Neoo One read it, so they can tell which conversation and project you are working on. Turn it off to keep only the application name.
  • Voice activation, to listen for "Hey Vato".
  • Neoo's general guide, to open the welcome guide again.

In Appearance, choose the Theme (Dark or Light) and the Interface style, arrange the surfaces in Header tabs, and turn the Desktop mascot on or off.

Interface style changes how Neoo looks and how you move around it:

  • Current (default): glass panels floating over the background, rounded corners, soft shadows and a blue accent. The header shows the Agent, GitHub, Canvas, Design and Bot tabs, and each surface has its own sidebar.

  • Minimal: flat panels attached to the window edges, neutral greys, and no shadows or glow: panels and toolbars are told apart by their background only. The only line left runs along a sidebar or the side panel, and fades out before the top and bottom of the window. Menus and dialogs keep a thin outline so they stand out from what they cover. Icons are Neoo's own set, drawn with a thin line and a single dot. Navigation becomes a single column on the left, which replaces the header tabs, the conversation sidebar and the Bots sidebar:

    • Ask Neoo, the bar at the top: the global chat, where Neoo answers or passes your message to the right Bot. See Neoo, the global chat. The magnifying glass at the end of the bar opens the command palette.
    • For you, at the top, lists only what is waiting for you, one line each: a Question (an agent or a Bot's work asks you something or needs a permission), a Finished result you have not opened yet, or a New message from a Bot. Questions come first, then results, each in order of arrival. Click a line to open it; the line of what is open is highlighted, as in the topic list below. A question leaves the list once you have answered it. A result stays, even after you opened it (its label turns grey, and a Bot's own conversation shows Seen), until you settle it, like in T3 Code: hover the line and click Settle, click the green Settle button at the top right of the open work or Bot conversation, next to …, or click Settle on the work's receipt in Neoo's chat. Settling from the line or from the top right always takes you back to Neoo's global chat. Settling a Bot's work also settles the Bot's own message about it. A result comes back if the work starts again or asks a question; a result left for three days settles by itself. What you settled is remembered on this computer. The section is hidden when nothing is waiting. A Bot's work is marked Finished only when Neoo was open while it ended.
    • One list of topics. A topic is a Bot (on this computer, on Neoo Cloud or on another computer) or an open folder. There are no separate sections for Bots and folders. Topics keep their place within the list: an agent that works, finishes or asks a question does not move its topic up or down. A topic moves to the top only when you send a message in it, or when it is new. The same goes for the conversations and works listed under a topic, with one exception: those that are working (spinner) are listed first under their topic, and go back to their place when they end. One waiting for your answer or with an unread result does not move up: it is in For you. The phone app follows the same rule in the Minimal style. A spinner on a line means something in it is working; an orange or blue number is how many of its questions and unopened results are in For you (a result you already opened is not counted).
    • Click a topic to open it. The open topic shows what it contains underneath: a Bot's works, or a folder's conversations and New conversation. Everything still in progress stays listed (working, waiting for your answer, a result you have not read); of the finished ones, only the three most recent are shown. Show more, under the list, adds ten more each time; the number next to it is how many are left. The one you have open stays listed.
    • Idle, at the bottom of the column, holds the topics with no activity, folded. A topic stays in the list above while something in it is working (spinner), while it has a line in For you (until you settle it), or when it is a pinned Bot (Pin in its … menu). Every other Bot and folder goes under Idle; the number next to it is how many. Click Idle to unfold it and click again to fold it; it starts folded each time Neoo opens. A topic comes back up as soon as it works or has something for you. The topic you have open always stays visible: one you opened from Idle stays there, even folded, and one that was already in the list stays in it until you leave it.
    • Actions on a line. Right-click a line, or hover it and click the … button at its end. A conversation of a folder offers Rename (the title becomes a field: Enter saves, Esc cancels) and Archive, which removes it from the list without deleting it. A Bot offers the actions of its own … menu (pin, mute notifications, hide, duplicate, delete…). A Bot's work offers Archive, Mute notifications and Delete. A folder offers New conversation and Remove from list: click it, then Confirm in the same menu. The folder leaves the list, and its conversations are deleted if you do not reopen it within 30 days. Show more and New conversation have no menu. A thin line links each of them to its topic, and each line starts with its state: a spinner while it works, an orange dot when it waits for your answer, a blue dot for a result you have not read, a check mark for a finished work. The grey number at the end of a Bot's line is how many of its works are running (hover it: Running: 2). Finished works are not counted, and a work waiting for your answer is counted in the orange number instead. A Bot with no running work shows no grey number.

    Around this main area, the window frame holds what is not a topic:

    • On the left, a narrow column of icons: GitHub, Design and Canvas (when they are visible in Header tabs), then More (Open a folder, New Bot, All Bots with groups, hidden Bots and invitations, Knowledge base, Shared data and Build my team). Settings and your account are at the bottom.
    • At the top, the title bar keeps the voice, updates, notifications and usage buttons, grouped at its right edge.

    The main area (the list of topics and what you opened) sits inside this frame on a lighter background, with rounded corners and a thin margin on the right and at the bottom. In a Bot, the conversation header is a single line: the Bot's name (click it to open Edit profile), then Works, which lists its background works. Inside a work, Conversation comes back to the chat; in a narrow window only its arrow is shown. On the right, ⋯ opens the Bot's actions, and the panel button shows or hides Overview, which is closed by default.

    Conversations read in a centred column about 760 px wide, shared by the messages and the message box. The short marks to the left of the column, one per message you sent, jump to that message; they only appear when the margin is wide enough to hold them, so they are hidden in a narrow conversation (for example next to an open side panel) instead of covering the text. The side panel on the right (browser, Live, files, a Bot's Overview) has the same background as the conversation, separated from it only by the same fading line as a sidebar. The message box is a rounded card one line high that grows as you type. Its buttons are round and borderless: + to attach, the model, the microphone, then send (a light disc with a dark arrow once there is something to send). While a turn is running, a ring with a square stops it. Each step of the agent's work has its own icon (command, file read, edit, search, web), and tools from connectors are named in plain words, for example Neoo Design · Get frame or Stripe · Create invoice.

The style works with both themes and applies immediately. It is saved on your Neoo account: choosing it on one computer switches your other computers, vatoide.com/app and the mobile app at the same time, without restarting (see The Minimal style on your phone). Signed out, Neoo remembers it on this computer only.

In Header tabs, drag a surface by its handle to change its place in the header (the arrow keys also move it), and click the eye to hide or show it. Agent always stays visible. You can do the same directly in the header: drag a surface icon onto another to reorder it, and right-click an icon, then choose Hide … from the header, to hide it. Hidden surfaces come back from Header tabs, in the position you gave them.

Workspace tools

SectionWhat it controls
ToolsAudit and clean up development resources used by Neoo.
PluginsThe browser, desktop control and API keys.
Neoo DesignNeoo Design and its local design tools.
AppSnapScreen capture, and how captures join active conversations.
WorktreesIsolated Git checkouts linked to your conversations, and their setup script. See Review changes.
SkillsReusable procedures available to your agents.

Data and connections

SectionWhat it controls
ProvidersYour AI provider accounts: connect, order and update them, and add Launch arguments for Codex. See Start your first conversation.
IntegrationsApps you connect for your agents and Bots, on all your devices.
VaultLogins, keys and server details your agents can use without ever seeing the secrets.
StorageYour storage budget (5 GB by default), local data, backups and space you can reclaim. See Disk space and cleanup.
ArchivesConversations removed from your current activity. Find and restore them here.

Usage

SectionWhat it controls
DashboardCosts, tokens and their breakdown.
Usage & quotasYour provider accounts, their quotas and reset credits.

Account

SectionWhat it controls
ProfileYour Neoo identity and the information tied to this session.
TeamYour team, its members and access to shared conversations.
Neoo CloudA hosted machine that runs your agents and Bots, even when your computer is off.