# Chat and projects

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/agent/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
At `/agent` you work with the assistant full screen: a large conversation column with the sidebar holding your chats and projects on the left. This is where you bundle related chats, share them with your team, and keep the overview via archive and favorites.
</Lead>

## The full-screen view

The start page `/agent` shows the conversation column with the composer (**Frag mich etwas oder beschreibe eine Aufgabe …**, ask me anything or describe a task). Every chat has its own address (`/agent/t/<id>`) that you can open directly or pass on, provided the chat is shared. Anything you start in the [mini assistant](/tools/agent/mini-assistent) can be continued here (**Im Vollbild öffnen**, open full screen).

## The sidebar

<DefinitionList>
  <DefItem term="Neue Aufgabe (new task)">The button at the very top starts a fresh chat.</DefItem>
  <DefItem term="Angeheftet (pinned)">Chats you starred as favorites appear in this group at the top (the group only shows once pinned chats exist).</DefItem>
  <DefItem term="Projekte (projects)">Your project folders, collapsible, with the **Neues Projekt** (new project) entry for creating one.</DefItem>
  <DefItem term="Chats">All remaining chats, sorted by recency.</DefItem>
  <DefItem term="Geteilt mit mir (shared with me)">Chats and projects colleagues have shared with you.</DefItem>
  <DefItem term="Wissensspeicher (knowledge vault)">The footer link leads to the semantic knowledge vault at `/agent/memory`. Details: [Knowledge and memory](/tools/agent/wissen-und-gedaechtnis).</DefItem>
  <DefItem term="Archiv (N) (archive)">Also in the footer: the number of your archived chats, one click opens the archive.</DefItem>
  <DefItem term="Account block">At the very bottom you see your credits bar (**Credits · verbraucht/gesamt**, used/total, and **Erneuerung in N Tagen**, renewal in N days) with a link to the credit settings at `/settings/credits`.</DefItem>
</DefinitionList>

<Info title="Empty sidebar?">
Before you get going, the groups show hints such as **Noch keine Chats** (no chats yet) or **Noch keine Projekte** (no projects yet) with the tip **Bündle Chats zu Projekten** (bundle chats into projects). An empty project reports **Noch keine Chats im Projekt** (no chats in this project yet). That is the normal starting state, not an error.
</Info>

## The chat menu

Every chat in the sidebar has a context menu with these actions:

<DefinitionList>
  <DefItem term="Umbenennen (rename)">Gives the chat a meaningful title instead of the automatically generated one.</DefItem>
  <DefItem term="Archivieren (archive)">Moves the chat to the archive. It is fully preserved and can be brought back any time.</DefItem>
  <DefItem term="Teilen (share)">Makes the chat available to colleagues. Shared chats appear for them under **Geteilt mit mir** (shared with me).</DefItem>
  <DefItem term="Favorit (favorite)">The star pins the chat to the top in the **Angeheftet** (pinned) group.</DefItem>
  <DefItem term="Projekt zuordnen (assign to project)">Moves the chat into one of your project folders.</DefItem>
</DefinitionList>

## Projects

Projects are folders for related chats, for example all chats about one property or one campaign. You create them via **Neues Projekt** (new project) in the sidebar and assign chats through the chat menu.

Every project has its own menu: **Umbenennen · Teilen · Löschen** (rename, share, delete).

<Warning title="Deleting archives, nothing is lost">
When you delete a project, the chats inside are not deleted but archived. You will find them in the **Archiv** afterwards and can keep working with them from there.
</Warning>

## Shared folders and multiplayer

When creating a project you can enable the **Geteilter Ordner** (shared folder) switch. You then either pick individual members or open the project to the whole workspace with **Für alle im Team** (for everyone on the team). For the recipients the folder appears under **Geteilt mit mir** (shared with me).

Shared chats are real collaboration (multiplayer): several people can write in the same chat, changes appear live for everyone, and you can see who is currently reading or typing.

## Archive

The archive at `/agent/chats/archive` collects all archived chats, including those from deleted projects. The number in the sidebar entry **Archiv (N)** shows how many chats live there. Archiving is the normal way to tidy up: content stays searchable instead of getting lost.

The list is grouped by month and shows, per chat, when it was archived, how many messages it holds, and which mode it ran in. The search at the top matches titles.

<DefinitionList>
  <DefItem term="Several at once">Tick the checkboxes on the rows you mean. Hold Shift to select a whole range. A bar then appears above the list with **Wiederherstellen** (restore) and **Löschen** (delete) for the selection.</DefItem>
  <DefItem term="Restore">The chat moves back into the sidebar and can be continued as usual. An earlier pin does not come back with it, you can set that again.</DefItem>
  <DefItem term="Delete permanently">The chat is deleted together with its history. This cannot be undone, so a dialog asks first and names the count.</DefItem>
  <DefItem term="Empty the archive">Deletes every archived chat at once, including those not loaded yet. The dialog names the total beforehand. Chats outside the archive are untouched.</DefItem>
</DefinitionList>

## Further reading

How to use the assistant on every other page is covered in [Mini assistant](/tools/agent/mini-assistent). What it can actually do is listed in the [capabilities reference](/tools/agent/faehigkeiten). Back to the [overview](/tools/agent).