Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.verdent.ai/llms.txt

Use this file to discover all available pages before exploring further.

Open projects from the Home screen or switch between them using Current Project in the Top Bar.

​
What You’ll Learn

  • Opening projects from Home screen
  • Switching between projects
  • How Verdent handles git setup

​
Opening a Project

From the Home screen, select a project directory to open. If your project isn’t already a git repository, Verdent creates one automatically for tracking changes and enabling workspace isolation.
Git 2.20+ is required for worktree support. See Git Installation for setup help.

​
Switching Projects

Click Current Project in the Top Bar to:
  • Switch to another open project
  • Access recent projects
When switching projects, all workspace states, task conversations, and running agents are preserved.

​
Base Workspace

Each project has a Base workspace (your original checkout on the main branch) and optional worktree workspaces for isolated work.
Workspace TypeDescription
BaseOriginal git checkout, typically on master branch
WorktreeIsolated workspace created for specific tasks

​
FAQs

No. Each project can only be open once. Use workspaces within the project for different branches or tasks.
Git state (commits, branches) is preserved as normal. Task history persists between sessions.
No. Verdent creates a git repository automatically if your project doesn’t have one.
They continue running. All workspace states, task conversations, and agent progress are preserved.
Click Current Project in the Top Bar to see and switch to recent projects.

​
See Also

Project Switching

Fast switching between projects

Git Installation

Setting up Git

Managing Tasks

Working with tasks

Workspace Isolation

Creating isolated workspaces