Projects

Open project folders, organize them in the sidebar and find the files your agents work on.

In Neoo, a project is a folder on your computer. Every conversation belongs to a project, and its agent reads and edits files inside that folder.

Open a project

When no project is open, Neoo shows its home screen:

  • Click Open a project and choose a folder.
  • Or click a folder under Recent projects.

When a project is already open, you can add another one:

  • Click the Open folder button at the top right of the sidebar list.
  • Or open the command palette with ⌘K on macOS or Ctrl+K on Windows. Type a project name to reopen it, or choose File: Open folder….
  • On Windows, you can also click the Neoo icon at the top left, then File → Open folder….

Opening a folder also starts a new conversation in it.

Choose the project of a new conversation

A new conversation asks What are we building in followed by the project name. Click the project name to pick another project from the list, or choose Open a project… to add a folder.

Above the question, a row of round icons shows the Neoo IDE icon and the providers listed in the model picker. Connected providers are in color; the others are grayed out and marked Unavailable. The last, slightly larger icon is the one that will answer your first message: the provider selected in the model picker, or the Automatic icon when Neoo routes the conversation. Your most used provider sits just before it. Providers hidden in Settings → Providers are not shown, and in a narrow pane the unavailable ones are left out. Hover an icon to see its name.

Click a connected provider's icon to switch the new conversation to it; the Neoo IDE icon switches to Neoo AI when it is connected. Neoo picks the model of your last conversation with that provider, or your first favorite model, and turns Automatic off for this conversation, just like choosing a model in the model picker. Unavailable icons can't be clicked. On a remote or Forge conversation the row is display-only: change the model from the model picker.

Organize the sidebar

The sidebar can list conversations in two ways. Switch with the button next to New Agent:

  • Activity: what is running, what needs your answer and what just finished come first, across all projects. Click a section header to fold it; folded sections move to the bottom of the sidebar.
  • Projects: one section per project under Repositories. Pinned conversations appear first, under Pinned.

In the Projects view, hover a project to see its buttons:

  • New conversation in this project starts a conversation in that folder.
  • Project actions opens a menu with Color, Open project and Remove from list.

You can drag a project to change its place in the list. Release it on another project to move it there; release it anywhere else, or press Esc, and it stays where it was.

Hide a project

Remove from list hides the project from the sidebar without deleting its conversations. Open the same folder again to bring it back.

If a project folder is missing

If you moved or deleted a project folder, Neoo shows This folder doesn't exist when you send the first message of a new conversation in it. Choose:

  • Create folder to create an empty folder at the same place.
  • Remove project to remove it from the sidebar.
  • Stop to do neither. Your message stays in the message field.

Find files

Neoo has no file tree. Agents search and read your project for you, and you reach files through the conversation:

  • Type @ in the message field to mention a file or a folder.
  • Click a file name in an agent's answer to open it. See Files and split view.
  • Review the files an agent changed in the changes card. See Review changes.