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


Creating New Tasks

Using the New Task Button

1

Open Workspace

Ensure you’re in the workspace where you want the task
2

Click New Task

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

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
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:
1

Create Planning Task

Task 1: Plan the feature in Plan Mode
2

Create Implementation Task

Task 2: Implement based on the plan
3

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

  • Starting a different topic
  • Asking a quick question
  • Different phase of work (plan → implement)
  • Clean slate for new approach
  • 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

Solutions:
  • Check task list in the Left Panel
  • You may be in a different workspace
  • Switch workspaces to find the task
Possible causes:
  • Very long conversation
  • Exceeded context limits
Solutions:
  • Summarize key points for the AI
  • Start fresh task with summary
  • Reference specific files
Solutions:
  • Close completed tasks
  • Consolidate related tasks
  • Use workspace organization

FAQs

No. Each task has its own conversation context. They share file state if in the same workspace, but not conversation memory.
Task history persists between sessions. You can resume tasks where you left off when you reopen Verdent.
Tasks don’t automatically know about other tasks. Reference files that were modified, summarize previous decisions, or use @-mentions to include specific files.
Yes. Each task has its own agent configuration including model selection.
Hover over the task in the task list and click the Delete button.
No. Tasks in different workspaces are fully isolated with no shared files or context.

See Also