Verdent Docs
This is archived Verdent 1.0 documentation. For current product documentation, see Verdent.

Managing Tasks

Create, switch, and organize tasks in Verdent

Tasks in Verdent are conversation threads within a workspace. This guide covers creating, switching, and organizing tasks for efficient multi-task workflows.


What You'll Learn

  • How to create new tasks
  • Switching between tasks
  • Organizing and naming tasks
  • Task context and state management
  • Best practices for task workflows

Understanding Tasks

What Is a Task?

A task is a conversation thread within a workspace. Each task:

PropertyDescription
ConversationHas its own message history
ContextMaintains its own AI context
AgentHas its own agent with custom configuration (model)
WorkspaceBelongs to a specific workspace
File AccessShares file state with other tasks in the same workspace

Task Hierarchy

flowchart TD
    P[Project] --> W[Workspace]
    W --> T1[Task 1: Plan feature]
    W --> T2[Task 2: Implement feature]
    W --> T3[Task 3: Review feature]

Creating New Tasks

Using the New Task Button

Open Workspace

Ensure you're in the workspace where you want the task

Click New Task

Click New Task or press Cmd+N / Ctrl+N

Start Conversation

Type your first message to begin the task

Automatic Task Creation

A new task is automatically created when you:

  • Submit a prompt in an empty workspace
  • Click New Task in the interface

What Happens When You Create a Task

StepDescription
Task CreatedNew conversation initialized
Context SetFresh AI context starts
ListedTask appears in task list
ReadyYou can begin interacting

Switching Between Tasks

Using the Task List

The task list in the Left Panel shows all tasks in the current workspace:

ElementDescription
Task listAll tasks in current workspace
Current taskHighlighted
Task previewFirst message or task name

Switching Methods

MethodHow To
Click in task listClick the task you want
New Task shortcutCmd+N / Ctrl+N creates and switches

State Preservation When Switching

When you switch tasks:

  • Full conversation history
  • AI context for the task
  • Model configuration
  • Where you left off
  • File state (same workspace)
  • Uncommitted changes
  • Branch state

Tasks in the same workspace share file state. If you need file isolation, use separate workspaces.


Organizing Tasks

Task Organization Tips

PracticeBenefit
One topic per taskClear, focused conversations
Related tasks same workspaceShared file access
Unrelated tasks new workspaceClean separation

Task Workflows

Plan → Implement → Review

Use multiple tasks for a complete workflow:

Create Planning Task

Task 1: Plan the feature in Plan Mode

Create Implementation Task

Task 2: Implement based on the plan

Create Review Task

Task 3: Review the implementation

All tasks share the same workspace, so they see the same files.

Quick Question During Work

When you need to ask a quick question without disrupting your main task:

  1. Create a new task (Cmd+N / Ctrl+N)
  2. Ask your question
  3. Get the answer
  4. Switch back to main task

Your main task's context is preserved.

Iterative Development

Recommended workflow pattern:

TaskPurpose
Task 1Initial implementation
Task 2Refinements and fixes
Task 3Final polish

Tasks share file state but have independent conversational context. You can return to any task later to review, refine, or continue work without its context being affected by other tasks.


Task Context Management

How Task Context Works

Each task maintains:

Context TypeDescription
ConversationAll messages in the task
AI MemoryWhat the AI knows about this task
ConfigurationModel selection and agent settings
ProgressWhere in the task you are

Context Between Tasks

ScopeBehavior
Same workspaceTasks share file state, not conversation
Different workspacesFull isolation

Best Practices

When to Create New Tasks

Good Reasons for New Task
  • Starting a different topic
  • Asking a quick question
  • Different phase of work (plan → implement)
  • Clean slate for new approach
When to Continue Same Task
  • Iterating on same feature
  • Follow-up questions
  • Continuing previous conversation
  • Building on established context

Task Hygiene

PracticeWhy
Keep tasks focusedBetter AI context
Don't overload topicsToo many topics confuse the AI
Close completed tasksKeep workspace clean
Review old tasksRemove tasks no longer needed
  • Start tasks with clear first messages
  • Group related work in same workspace
  • Use workspaces for major separations

Troubleshooting

Common Issues

Can't find my task

Solutions:

  • Check task list in the Left Panel
  • You may be in a different workspace
  • Switch workspaces to find the task
Task lost context

Possible causes:

  • Very long conversation
  • Exceeded context limits

Solutions:

  • Summarize key points for the AI
  • Start fresh task with summary
  • Reference specific files
Tasks piling up

Solutions:

  • Close completed tasks
  • Consolidate related tasks
  • Use workspace organization

FAQs

Do tasks share memory?

No. Each task has its own conversation context. They share file state if in the same workspace, but not conversation memory.

What happens to tasks when I close Verdent?

Task history persists between sessions. You can resume tasks where you left off when you reopen Verdent.

Can I reference work from other tasks?

Tasks don't automatically know about other tasks. Reference files that were modified, summarize previous decisions, or use @-mentions to include specific files.

Can I use different models for different tasks?

Yes. Each task has its own agent configuration including model selection.

How do I delete a task?

Hover over the task in the task list and click the Delete button.

Do tasks in parallel workspaces share anything?

No. Tasks in different workspaces are fully isolated with no shared files or context.


See Also