Organize work in projects

Last published : Nov 09, 2026
This guide shows you how to group related chats in a project, give them standing instructions, and summarize what they produced.
A project keeps related chats together with a shared folder and shared context. Every chat in a project works in the same folder, so each one can build on what the others produced.
Related information
Use Knowledge Worker Agent

Create a project

  1. In the sidebar, next to Projects, select New project (+).
  2. Enter a Name, for example Acme Deal.
  3. Optional: enter a Description.
  4. Optional: to use a Git repository as the project's folder, select Back this project with a GitHub repository, and enter the Repository URL.
  5. Select Create project.
Without a repository, the project gets a new folder under ~/Knowledge_Worker_Agent/Projects. With one, the repository is cloned and used as the project's folder.

Start a chat in a project

  1. In the sidebar, select the project. The project view opens.
  2. Select + New chat.
A chat in a project shows In followed by the project's name at the top. Select it to go back to the project view.

Find a project's chats

The project view lists its chats under Starred and All chats. To filter them, type in Search this project's chats….
To star a chat within the project, select its star. This is separate from starring a chat in the sidebar's Chat sessions.
The project view also shows the Shared workspace: the project's folder, with the same controls as the Files panel. For more information, see Work with files.

Give the project standing instructions

  1. In the project view, select ⚙ Settings.
  2. Under Project instructions, enter guidance for every chat in the project, for example the terminology to use.
  3. Select Save.
The instructions apply to every chat in the project, in addition to your workspace's own instructions.

Choose the project's connectors

Every chat in a project uses the same connectors.
  1. In the project view, select ⚙ Settings.
  2. Under Connectors, select each connector to turn it on or off for the project.
Each change applies at once to every chat in the project.
Only connectors that are on in your workspace are listed. If none are, turn one on first. For more information, see Manage connectors.

Summarize a project

The assistant can combine what several chats produced into one summary file.
  1. In the project view, select 📝 Summarize.
    The Summarize project dialog lists the project's chats. Chats active this week are already selected.
  2. Select the chats to include. To select every chat, select Select all.
  3. Optional: under Extra instructions, say what to focus on, for example open decisions.
  4. Select Summarize. The button shows how many chats you selected.
The dialog closes, and the chat that writes the summary opens so you can watch. The summary is saved as PROJECT_SUMMARY.md in the project's folder. Each run replaces the file. If the project is backed by a repository, the file is committed and pushed.

Keep a repository-backed project up to date

For a project backed by a repository, Knowledge Worker Agent checks for new commits every five minutes. It pulls them only when the folder has no uncommitted changes and no commits of its own, and no chat in the project is running.
At the top of a project chat, you may see one of these suggestions:
  • A message saying how many new commits the project repository has. Select Pull to pull them.
  • "You have uncommitted changes in this project." Select Commit… to commit them.
For more information, see Work with Git.

Rename or delete a project

In the sidebar, point to the project:
  • To rename it, select Rename project (✎).
  • To delete it, select Delete project (🗑), and confirm.
Deleting a project keeps its chats and its files. The chats become regular chats, and the project's folder stays on disk.