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