ZeroTwo desktop app
ZeroTwo on the web
ZeroTwo desktop app
ZeroTwo desktop app
Use a project to organize related chats and give ZeroTwo the context it needs.
The Projects view in the ZeroTwo desktop app includes ZeroTwo projects and
local projects that connect to folders on your computer.Choose a project or start without one
Create a project when work will continue over time, produce more than one
output, or depend on the same files and sources. Start a chat without a project
when the work is self-contained and doesn’t need shared project context. Use a project to keep related chats, files, instructions, and sources together.
The same project can contain chats started with Chat or ZeroTwo Work.Choose a project or chat without one
Create a project when work will continue over time, produce more than one
output, or depend on the same files and sources. Start a chat without a project
when the work is self-contained and doesn’t need shared project context.Each project has a Chats section that lists project chats and a Sources
section for uploaded files and connected context. Project instructions apply
across its chats. A ZeroTwo project doesn’t provide direct access to a folder on
your computer, so upload or connect the sources you want ZeroTwo to use.With either option, start a new chat from the project to use its shared files and
instructions, then return to it under Chats. ZeroTwo desktop app treats the directory where you start it as the project for the chat.
Run ZeroTwo from the directory you want ZeroCode to work in, or pass
--cd <directory> (-C) to set it explicitly. The CLI doesn’t expose the
ZeroTwo Projects view.
The desktop app treats the folder or workspace open in your IDE as the local
project. In a multi-root workspace, select the workspace root for the chat. The
extension doesn’t expose the ZeroTwo Projects view from the web or desktop app.
ZeroTwo desktop app
ZeroTwo on the web
ZeroTwo desktop app
ZeroTwo desktop app
Work in a project
The Projects view brings ZeroTwo projects and local projects into one place.
ZeroTwo projects carry project files and context across related chats. A local
project gives chats access to one or more folders on your computer, such as a
collection of source files or a codebase.Start a separate chat for each distinct outcome so its messages and results stay
focused while the project keeps related work organized.Work in a project
A ZeroTwo project gives its chats access to the same uploaded files, project
instructions, and connected sources. Use Chat for a quick chat or
ZeroTwo Work for a larger deliverable; both appear as chats in the project’s
Chats section. Start a separate chat for each distinct outcome so its
messages and results stay focused while the project preserves shared context.Work in a project directory
Start ZeroCode from the directory that should provide the chat’s file context. Use
/new to start a separate chat for each distinct outcome. Use /resume while
ZeroCode is open, or run zerocode resume, to continue a saved chat.The chat keeps its transcript and recorded working directory, while ZeroCode reads
files from the current working tree. Keep durable project guidance in
AGENTS.md or checked-in documentation so it is available to future chats.Work in a workspace
Open the folder or workspace that should provide the chat’s file context. Start
a new chat for each distinct outcome, then select it from Recent chats to
continue it. Chats in the same project can work with the same files, while each
chat keeps its own transcript.The current selection and open files provide context for the current turn. Keep
durable project guidance in AGENTS.md or checked-in documentation so it is
available to future chats. ZeroTwo desktop app
ZeroTwo on the web
ZeroTwo on the web
Organize projects and chats
Keep active work visible and move finished work out of the way:
- Pin a project to keep it near the top of the sidebar. You can also pin it
from the Projects view.
- Pin a chat when you return to it often, even if newer chats appear in the
project.
- Rename a chat with a short title that describes its outcome, such as “Q3
launch brief” or “Checkout accessibility review.”
- Search projects from the Projects view. Press
Cmd/Ctrl+G to search past chats when you
remember a phrase or branch name but not the title.
- Archive a chat when you finish the work. From a project’s menu, select
Archive chats to archive its chats together.
Pinning doesn’t add context or change what ZeroTwo can access. It only changes
where the project or chat appears in the sidebar.Restore archived chats from Settings > Archived chats.Organize projects and chats
Keep active work visible and move finished work out of the way:
- Pin a project to keep it near the top of the sidebar. You can also pin it
from the Projects view.
- Pin a chat when you return to it often, even if newer chats appear in the
project.
- Rename a chat with a short title that describes its outcome, such as “Q3
launch brief” or “Checkout accessibility review.”
- Search projects from the Projects view. Search past chats with
Cmd/Ctrl+K when you remember a phrase or
branch name but not the title.
- Archive a chat when you finish the work.
Pinning doesn’t add context or change what ZeroTwo can access. It only changes
where the project or chat appears in the sidebar.Restore archived chats from Settings > Data Controls > Archived chats.
Use local projects for folders and codebases
Add a local project when ZeroTwo needs to read or change files on your computer.
Projects don’t need a folder, but you can attach folders as needed.
To add or change folders, open the project’s menu and select Edit project.
Select Add folder to attach multiple folders. ZeroTwo can read and change files
in every attached folder. To change the default working directory, point to a
folder and select Make primary.
New chats start in the primary folder. ZeroCode also uses that folder as the
default for Git operations and automatic discovery of AGENTS.md, skills, and
config.toml. Secondary folders remain available for file search, reading, and
editing, but ZeroCode doesn’t automatically discover those project files from
secondary folders.
Use multiple folders when related work lives in different places, like an app and
its documentation or a website and its backend. Create separate projects for
unrelated work or when each chat should access only one part of a repository.
This keeps the working context focused. Remote projects currently support one
folder.
Use local environments to define setup
actions and common commands for a project. The review
pane can show changes across repositories
attached to the same project. Pull request and
worktree actions target the primary
repository. When you start a chat in a worktree, the other folders remain
attached.
Projects and worktrees organize work, but the sandbox
enforces what local commands can read, change, or access over the network.
ZeroTwo desktop app
ZeroTwo on the web
Start a chat without a project
Select New chat when the work is self-contained and doesn’t need shared
project files, instructions, or folder access. Create a project first when
several chats will depend on the same context.Start a chat without a project
Start a chat from ZeroTwo Home when the chat doesn’t need shared project
files, instructions, or sources. You can use Chat or ZeroTwo Work; on the web,
both create chats.If the work grows, move it into a project and use clear chat names for each
outcome. A project can hold parallel chats for research, drafting, review, and
follow-up without mixing every message into one context.Use Quick chat for a quick question
Quick chat opens an ordinary ZeroTwo chat. ZeroTwo chats don’t appear in the
ZeroCode sidebar, which contains your ZeroCode chats and projects.
Point to New chat, then select the Quick chat icon on its right. You can
also press
Cmd+Option+N on macOS or Ctrl+Alt+N on Windows. From New
chat, you can open an existing ZeroTwo chat and add it to a ZeroCode chat.
Bring in other tools and context
ZeroTwo desktop app
ZeroTwo desktop app
ZeroTwo desktop app
ZeroTwo on the web
- Attach files or image inputs directly to a chat
when they apply only to that request.
- Install plugins to bring in context and actions from other
services.
- Configure MCP servers when your organization or developer setup
exposes tools through Model Context Protocol.
- Use memories, where available, to carry useful context from
past work into future chats.
- Pass image inputs to a chat when visual context applies
only to that request.
- Install plugins to bring in context and actions from other
services.
- Configure MCP servers when your organization or developer setup
exposes tools through Model Context Protocol.
- Use memories, where available, to carry useful context from
past work into future chats.
- Reference open files or select code in the editor to add context for the
current turn.
- Configure MCP servers when your organization or developer setup
exposes tools through Model Context Protocol.
- Use memories from the connected ZeroCode host, where
available, to carry useful context into future chats.
- Add files and connected sources to the project’s Sources section when they
should be available across its chats.
- Attach files or image inputs directly to a chat when
they apply only to that chat.
- In ZeroTwo Work, install plugins to bring in context and
actions from other services.
- Use memories, where available, to carry useful context from
past work into future chats.
Next steps
Last modified on August 30, 2026
