Projects

A project is the workspace an agent operates in. Everything an agent does — chats, plans, files, and tool calls — happens inside a project.

Open Projects in the sidebar and click New Project to create one. Your projects also appear in the sidebar so you can switch the active project at any time.

Switching the active project from the sidebar.

Cloud vs. local projects

Cloud projects are fully managed. The agent’s working files live in the cloud and nothing is required on your machine. Good for self-contained tasks. Creating a cloud project requires an active Plus or Pro plan — see Plans & Pricing. On the Free plan, Tanzanite shows an upgrade prompt instead.

Local projects point at a folder on your own computer. When you create one, Tanzanite opens a native folder picker and requests file-system access to that folder. The agent reaches it through the local bridge — a secure WebSocket connection between the app and the agent runtime — so it can read, write, and edit your real files. This is what makes Tanzanite useful for working on existing codebases and documents. For local projects you can also configure build, run, and dev commands in the project’s settings.

The local bridge

When you open a local project, the app exposes file-system tools to the agent over the bridge. The agent can list, read, and write files in that folder only. Sensitive actions surface as approval requests before they run.

Connectors

Projects can be backed by external sources through connectors (for example, a Git repository). Connectors route the agent’s working directory to the right place so it operates against the correct files.

Next steps

• See how Agents & Chat run inside a project.
• Automate recurring work with Workflows & Schedules.