Overview
Archiving removes completed tasks from your active view and cleans up their worktree directories. This keeps your project dashboard focused and reclaims disk space.When to Archive
Archive tasks when:- Changes have been merged to the target branch
- Work was completed but not needed (exploratory tasks)
- Task was superseded by another approach
- You need to free up disk space
How to Archive
Single Task
- Open the task’s context menu (⋯)
- Click Archive
- Confirm the action
Bulk Archive
- Go to Project → Tasks list view
- Select multiple completed tasks
- Click Archive Selected
What Happens When You Archive
| Component | Action |
|---|---|
| Worktree | Deleted from .zenflow/tasks/{task_id} |
| Branch | Optionally deleted (configurable) |
| Task record | Moved to archived view |
| Chat history | Preserved for reference |
| Artifacts | Preserved in archived view |
Viewing Archived Tasks
Archived tasks aren’t gone—they’re just hidden from the active view:- Go to Project → Tasks
- Click the Archived filter
- Browse or search archived tasks
Restoring Archived Tasks
If you need to continue work on an archived task:- Find the task in the archived view
- Click Restore
- Zenflow recreates the worktree from the branch
Restoration requires the task branch to still exist. If the branch was deleted, you’ll need to create a new task.
Automatic Cleanup
Configure automatic archiving in project settings:| Setting | Description |
|---|---|
| Auto-archive after merge | Archive tasks when their PR is merged |
| Archive stale tasks | Archive tasks inactive for N days |
| Delete branches on archive | Remove task branches when archiving |
Disk Space Management
Each worktree is a full copy of your repository’s working files. Monitor usage:- Disk space warnings
- Slow Git operations
- Many stale tasks in the Kanban board
Next Steps
Tasks Overview
Complete guide to task management
Git Worktrees
How task isolation works