Projects come in two kinds. Cloud projects hold chats, instructions and sources and sync everywhere. Local projects point at folders on your computer so Work and Code can read and edit them.
Choose a project or start without one
Create a project for ongoing work with shared files or standing instructions. Skip it for self-contained questions. A Free account can have one project; paid plans have no such cap.
Work in a project
A cloud project's page has Chats and Sources tabs. Open Project settings to set a name, icon, colour and Instructions, which tell ZeroTwo how to respond throughout the project. Under Sources, Add sources takes uploads, pasted text, files from your Library, Google Drive and URL context. Start new chats from inside the project so they inherit its instructions and files, and share the project with Share project as Can view, Can edit or Admin.
Organize projects and chats
Pin a project from its row menu, and pin individual chats too; pinning only reorders the sidebar. Rename a chat to the outcome it produced, and find old ones with Search chats (Mod+K) or the shortcuts in Settings > Shortcuts. Archive finished chats from the row menu, and restore them from Settings > Data Controls > Archived chats (the desktop app also has an Archived tasks tab).
Use local projects for folders and codebases
On desktop, a local project is a folder you add with Add new project in the project picker. To attach more, open Edit project > Source folders > Add folder. Every attached folder is readable and editable, but folders may not nest inside each other or already belong to another project. The first folder carries a Primary badge, and Make primary moves another one to the front.
The primary folder is the working directory for commands, owns Git operations, worktrees and change review, and is where ZeroTwo looks for project instructions (the first non-empty of ZEROTWO.md, AGENTS.md or CLAUDE.md) and skills. Searches without an explicit path cover only the primary folder, so name the other folder when you want it searched. Use several folders for related code and docs, and separate projects for unrelated work.
Local runs execute on the desktop that started them. If that computer goes offline, the run stops unless you are on Ultra with Keep working in the cloud turned on, which moves an offline Code task to a cloud sandbox; see Pricing. On macOS commands run inside an OS sandbox, while on Windows and Linux approvals are the safeguard; see Sandboxing.
See the review pane for changes across the repo and worktrees for isolated checkouts of the primary repo. To drop a local project from the sidebar, use Remove project in its row menu; the folder itself is untouched.
Start a chat without a project
Press New chat (Shift+Mod+O), click the ZeroTwo wordmark or choose Home for a chat that needs no shared context. Move it into a project later with Move to project from the chat's menu when the work grows.
Bring in other tools and context
- Attach files or images from the + menu: up to 10 files per message, 50 MB each.
- Use plugins, MCP servers and memories in any chat.
- In a project, add Sources so every chat can search them.
Next steps
See prompting, using ZeroTwo and long-running work.