prune_closed
Remove closed tasks from Task Trellis MCP to optimize system performance and maintain cleanliness. Specify age in minutes and optional scope to prune completed, cancelled, or archived objects safely.
Instructions
Prunes closed objects from the task trellis system
Use this tool for maintenance and cleanup of completed, cancelled, or otherwise closed objects that are no longer needed. Essential for system hygiene and performance optimization.
Pruning criteria:
'age': Minimum age in minutes since object closure (required)
'scope': Limit pruning to specific project or area (optional)
Objects must be in closed states (completed, cancelled, archived)
Objects must not have active dependencies or relationships
Safety mechanisms:
Only removes truly closed objects (completed, cancelled, etc.)
Validates no active objects depend on pruned items
Preserves objects referenced by active work
Maintains referential integrity of remaining system
Common usage patterns:
Daily cleanup: age=1440 (24 hours)
Weekly maintenance: age=10080 (7 days)
Project closure: scope='project-name', age=4320 (3 days)
System cleanup: age=43200 (30 days)
Pruning benefits:
Reduces database size and improves query performance
Removes clutter from active task views
Prevents accumulation of obsolete work items
Maintains focus on current and relevant tasks
Use regularly as part of system maintenance to keep the task trellis clean and performant. Consider project lifecycles and audit requirements when setting age thresholds.
This operation is permanent - pruned objects cannot be recovered.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | Yes | Age in minutes for objects to be considered for pruning | |
| scope | No | Scope to prune objects from (optional) |