Opening Projects
How to open and manage projects in Verdent
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 Type | Description |
|---|---|
| Base | Original git checkout, typically on master branch |
| Worktree | Isolated workspace created for specific tasks |
FAQs
Can I open the same project twice?
No. Each project can only be open once. Use workspaces within the project for different branches or tasks.
What happens to my project when I close Verdent?
Git state (commits, branches) is preserved as normal. Task history persists between sessions.
Does my project need to be a git repository?
No. Verdent creates a git repository automatically if your project doesn't have one.
What happens to running agents when I switch projects?
They continue running. All workspace states, task conversations, and agent progress are preserved.
How do I access recent projects?
Click Current Project in the Top Bar to see and switch to recent projects.