Projects

A project is the top-level container in Agentissimo. It groups workspaces, agent sessions, settings, and chat history under one name — so switching between codebases means switching one project, not reconfiguring everything.

What a project holds

• Workspaces — one or more workspaces, each with its own repo members.
• Settings — driver, model, chime, and Terminal AI config scoped to the project.
• Chat history — all agent sessions and their transcripts.
• Memory — the project brain, with episodes captured from its sessions.

Switching projects

Use the project switcher in the banner to move between projects. Each project restores its own workspace layout, open chats, and panel state.

Grouping workspaces

The Projects panel can group a project’s workspaces into named folders. Create a group from the project row’s ⋯ menu, then drag that project’s workspaces into it. A group belongs to one project and renders inside it, above the project’s ungrouped rows; a workspace from another project is refused. Grouping changes only the panel layout: activation, rename, remove, branch, and member behavior stay as they were.

Each group has its own pinned section. Pin a workspace inside a group to keep it at the top of that group without moving it into the global pinned section. The global Pinned section stays cross-project — use it for a working set that spans more than one project.

Every row states its agent status in one place: the leading icon becomes a coloured dot — needs input, running, error, finished — and returns to the folder or branch icon when the row goes quiet. A row with agents in more than one state shows the one that wants you first, so a collapsed group still tells you where to look. A group’s dot considers only the workspaces it currently shows, so it narrows with the panel’s filter.

The project header reads the same way for the whole project: every workspace it owns, whether grouped, ungrouped, or pinned into the global Pinned section. It narrows with the filter too. The banner’s project and workspace breadcrumbs carry the same dot.

One project per repo (default)

When you open a repo for the first time, Agentissimo creates a project automatically. Most users work with one project per codebase. For cross-repo work, add multiple repo members to a single workspace within the project — see Workspaces & worktrees.