Projects

A project is a folder on your computer that TokenWork keeps track of — usually one codebase. Switching projects switches the folder the agent works in, along with that project’s sessions and settings.

Add a project

You can add a project from a few places:

• the Add project entry in the command palette
• the + button at the top of the session sidebar
• the folder browser when you pick a directory

Point it at a folder and TokenWork remembers it. The name comes from the folder; you can change it later.

Switch projects

Pick a project from the sidebar to make it active. Everything — sessions, git, notes — follows the project you have open.

Make a project recognizable

Open Settings → Projects to give a project a custom name, color, or icon. TokenWork tries to find an icon automatically — see Project icons.

In VS Code, TokenWork always uses the folder you have open as the only project, so there’s nothing to add or switch. The Projects settings page is hidden there.

Related

• Project Notes, Todos & Plans — keep working notes per project
• Project Actions — save commands you run often
• Context — see how much of the model’s memory a session is using