Projects Home

  • Desktop app
  • All plans

What it does

The screen you see when no project is selected: every project of the account as a grid grouped by folder, with a big search bar on top and a toolbar to sort and filter. The search bar has two modes plus a shortcut: Projects filters the grid (and the sidebar and the project switcher at the same time, since they share one search), Build opens the welcome chat under the bar so you can say what you want in plain words and be taken there, and Help is not a mode at all, it opens the AgentsRoom Help bubble. Filters narrow the grid by machine (which computer hosts the repository) and by tag (free labels you put on projects). A Recently opened card in the left panel answers "where was I" at all times.

Since 1.181.0 the same large bar sits on top of every list of the app: Teams, Triggers, Tunnels, the Prompts, Skills and Memory libraries and their Community tab, the Backlog board, Radar, Dev commands, SSH connections, Databases and Secrets. Each one says what it searches (Search a team by name, purpose or role, Search triggers, Search a tunnel or a server), has the same Clear the search button, and a list that finds nothing says so instead of looking empty. The controls that belong to the search (scope, sort, category) sit inside the bar; the create buttons sit on their own row.

Where to find it

  • Click the AgentsRoom home (deselect the current project) or open a project's parent list from the sidebar.
  • The search bar sits at the top of the page, with the Projects / Build / Help selector on its right.
  • Each zone ends with a dashed + tile split in three: Open project (a folder you already have; its dialog also takes an optional Mission, see Workspaces), Create a workspace (a name and a mission, no repository) and Open the guide.
  • Toolbar next to the grid: sort Recent / Name, Duplicates, Filter by machine, Filter by tag. On the right of the same toolbar: New folder, then Import (since 2026-10-29, one menu: Scan a folder to add many projects of one folder at once, GitHub, GitLab).
  • Tags are set in the project modal (creation and edit), field Tags, and shown as chips on the project card (three visible, then +N).
  • The project modal's Folder field shows every folder as a chip with its project count, No folder first for the root. Picking a folder that has sub-folders unfolds them on the row below; New folder at the end of the first row (Subfolder on the rows below) creates one in place and selects it. The phone's Folder field unfolds the tree the same way, without creation.

How to use it

  1. Type in the bar: the grid shrinks as you type; Enter opens the first tile, Escape clears.
  2. Switch to Build to describe what you want: the conversation opens under the bar and ends on one button that performs the action. It is the same chat as the first screen of a fresh install, see Welcome Chat. Help opens AgentsRoom Help instead and leaves the bar as it was.
  3. Filter by machine: choose All machines, This machine or a named host (an SSH offload server, another desktop of the account). The list only appears when there is more than one host.
  4. Filter by tag: click one or several tags; they combine as a union (client-x OR perso). Clear removes them. The row only appears once at least one project is tagged.
  5. Duplicates keeps only projects that share a name, handy after importing clones.
  6. New folder creates an empty zone without a project: click it, type the Folder name and press Enter. The zone's settings open right away on the Workspaces tab so you can choose where its workspaces will be stored, and the empty zone stays on the home with its own + tile until you file something in it. Its Root folder card offers Create the first workspace.
  7. Each folder group's header carries two always-visible buttons next to its name: the gear (Folder settings, the defaults its projects inherit) and the bin (Delete folder (children move up)). The bin asks "Delete the folder "X"? Its contents move up one level." and destroys nothing: the projects and sub-folders inside move up, on this computer and on every other computer of the account.

Tags: up to 8 per project, 24 characters each, case-insensitive ("Prod" and "prod" are the same tag). A tag typed in any project search also matches.

Rename a folder

Folders are renamed from the sidebar, not from the home grid (the group header on the home only has the gear and the bin).

  1. In the sidebar, hover the folder's row: its buttons appear on the right.
  2. Click the pencil, Rename folder (or double-click the folder's name).
  3. Type the new name and press Enter. Escape cancels; clicking elsewhere keeps what you typed. An empty name is ignored.

Only the name changes: the projects inside, their folders on disk and the folder's settings stay as they are. The folder's memory (the knowledge shared by all its projects) follows the new name. No need to recreate the folder and move the projects into it.

Delete a project

Three places: right-click the project in the sidebar > Delete Project; the More actions menu (⋯) on its card on the home or in the project switcher > Delete Project; or Project settings > General, Delete project at the bottom. Each one asks for a confirmation first, and each confirmation says "The project folder and its files stay on disk." (except when you tick the box that deletes a demo folder); the two menus also warn when the project still has running sessions ("2 active sessions will be closed").

What it removes, on this computer:

  • the project from the sidebar, the home and the row of opened projects;
  • its running agent consoles and terminals, which are stopped, and its embedded browser screens;
  • its entry on your account, so it no longer comes back here as an account card.

What it keeps:

  • the folder on disk and every file in it: AgentsRoom never deletes your repository. The only exception is a demo project created by the app, where a checkbox offers to delete its demo folder too;
  • the project's saved agents (they live in the project folder), its backlog tickets and its memory: open the folder again with Open project and they come back;
  • the project on your other computers that have it open: deleting is local to this computer;
  • another copy of the same repository open on this computer, which is not touched.

Project cards: KPIs and the assistant bar (since 2026-10-20)

Each card shows the project's counters: its agents in Needs you, To review and Working (the same words and colours as the counters above a project's agent list), then its backlog tickets In progress and In review. A counter at zero is not shown; the chip next to the folder now gives the agent head count only.

The card ends with a Project assistant bar: the assistant's portrait, with a dot for its state (red: it needs you, green: an answer to read, amber: working). One click opens the console of the project's assistant directly, without opening the project first; a project that never had an assistant gets one at that click. To come back to the grid: the title bar's Home button (Escape inside the console goes to the assistant, as in any agent console). Going from one project's assistant to the next is two clicks. The bar is hidden when the assistant is hidden for that project or for the account, see Project assistant (chief of staff).

A project whose folder is gone (since 2026-11-05)

If a project's folder was deleted or moved outside the app, or its drive is unplugged, the project stays in the list with a Folder missing mark (on its card, its sidebar row and in the project switcher), and AgentsRoom no longer recreates the folder. Clicking the project opens Project folder not found: it shows the path it was at, and lets you select the new folder, clone the repository when the account knows its address, or remove the project with Delete project. When the folder comes back (drive plugged in again, folder put back), the project takes its path back by itself, at the latest the next time you return to the window. Nothing is deleted automatically, and such a project holds no place under your plan's project limit.

Settings

  • hideWorkProjects (global, Settings > View): hide the projects of the "Work" zone (demo aid).
  • The three filters (machine, tags, duplicates) are never persisted; only the sort survives a restart.

Agent tools (MCP)

  • projects_list: the same project list, for agents.
  • projects_open: adds a folder that already exists on this computer as a project, like Open project (since 2026-10-26, on your request).
  • projects_rename: changes a project's display name, never its directory.
  • projects_folders_get / projects_folders_apply: read the folder tree of the sidebar, create folders and move projects into them, like a drag and drop. See AgentsRoom MCP.

Providers

All providers, no difference.

Mobile

Project search and tags are on the phone with the same words, the same limits and the same union rule (Filter by tag, Search projects…). The cards of the Projects tab (Activity and Groups views) carry the same counters and Project assistant bar; the console's back arrow returns to the list. The bar is hidden for a project that is not on the connected computer. The machine filter is not on the phone; the phone keeps its own Activity / Groups toggle. The Build and Help cells are not on the phone.

The + button in the header of the Projects tab (Add a project) is the phone's counterpart of the + tile: Open an existing project (browse the connected desktop's folders) and Create a workspace, both executed on the connected desktop. Details in Workspaces. New folder is desktop only; the zones it creates are offered in the phone's Folder selector the next time the sheet opens.

Limits

  • Tags live in the project's local configuration: they do not sync to another computer.
  • Deleting a project here removes it from this computer; it stays on your other computers that have it open. See Delete a project above.
  • A folder is renamed from the sidebar only, on the desktop; no agent tool renames a folder yet (projects_folders_apply creates folders and moves projects).
  • Tag chips are shown on the home cards only, not in the sidebar or the project switcher (search still matches them there).
  • When a filter leaves nothing, the grid explains it and offers Reset the filters; a search with no match says so separately.
  • The free plan opens a limited number of projects at once; the grid still lists all of them.

Common questions

  • Can I open a project's assistant without opening the project? Yes, with the Project assistant bar at the bottom of its card; the title bar's Home button (phone: the back arrow) brings you back to the list.

  • Two rows of Recently opened have the same name. Which is which? Since 2026-11-12, when two projects share a name, each row says where it lives: its folder, otherwise the computer that has it, otherwise Not on this machine. Nothing is merged; remove the extra row from its right-click menu if you do not need it here.

  • Where did the Activity / Groups view switch go? Removed from this page: the grid is always grouped by folder, and the Recently opened card in the left panel gives the activity order permanently.

  • Why does my machine filter not show up? Every project is on this machine: the filter appears only when a second host exists.

  • Can I search by folder path? Yes, the search matches name, zone, path and tags.

  • Are tags folders? No: a project sits in one folder but can carry several tags.

  • How do I create a folder before I have a project to put in it? New folder in the toolbar: it creates the zone empty and opens its settings on the Workspaces tab. The zone stays on the home with a + tile.

  • I created a folder and it vanished when I closed its settings. Fixed on 2026-09-15: an empty zone now stays painted on the home, except while a search or a filter narrows the grid.

  • How do I rename a folder (a group of projects)? In the sidebar, hover the folder's row and click the pencil Rename folder, or double-click its name. Type the new name and press Enter.

  • Does deleting a project delete my files? No. Delete Project only removes it from AgentsRoom on this computer; the folder and its files stay on disk, and Open project on the folder brings back its agents and backlog.

  • How do I get rid of a group of projects I created by mistake? The bin in the group's header on the home (or the same action in the sidebar). What was inside moves up one level; no project and no file is deleted.

  • I deleted a folder and it came back when I opened AgentsRoom on my other computer. Fixed on 2026-09-29: a deletion now travels with the folder tree as a fact of its own, so the other machine learns about it instead of pushing its own copy back. Both machines need the fix; the children are re-parented one level up on each of them.

  • Escape in a search bar closed the window instead of clearing my query. Since 1.181.0 Escape empties the bar first (on the home and on every list); a second Escape, with the bar empty, closes the window as before.

  • Why is there no search bar in my Teams window? It appears from two teams: with a single team there is nothing to search.

  • I deleted a project's folder and it keeps coming back empty. Fixed on 2026-11-05: AgentsRoom used to recreate it at launch, with only its own .agentsroom files. The project now shows Folder missing and the folder stays gone. Delete the empty folder one last time if it is still there, and remove the project if you no longer want it.

  • I moved a project to another folder and it says Folder missing. Click it and select the new folder: agents, backlog and memory follow. Opening the new folder with Open project does the same.

  • My external drive was unplugged and my projects show Folder missing. Plug it back in: they take their path back by themselves. Do not remove them, nothing is lost.

  • How do I remove a project whose folder no longer exists? Click it, then Delete project at the bottom of the dialog, or use the menu on its row. The folder on disk is never touched.

  • I deleted a project and it came back because my other computer still has it. Fixed on 2026-11-10: Delete project removes the project from this computer only, and it no longer comes back as an account card when another computer of the account still has it open (it stays there). To bring it back here, open its folder with Open project: agents and backlog follow. If you delete one of two copies of the same repository on this computer, the other copy is not touched.