list_objects
Retrieve and filter objects in the Task Trellis system by type, scope, status, or priority. Use this tool to discover work items, understand project structure, and identify objects needing attention.
Instructions
Lists objects from the task trellis system
Use this tool to retrieve and filter objects based on various criteria. Essential for discovering existing work items, understanding project structure, and finding objects that need attention.
Available object types:
'project': Top-level containers
'epic': Large features within projects
'feature': Specific functionality within epics
'task': Individual work items
Available status values:
'draft': Initial state for new objects
'open': Ready to begin work (default for new objects)
'in-progress': Currently being worked on
'done': Completed successfully
'wont-do': Cancelled or decided against
Available priority values:
'high': Critical or urgent work
'medium': Standard priority
'low': Nice-to-have or future work
Key filtering options:
'type': Filter by object category (project, epic, feature, task)
'scope': Limit results to a specific project or area of work
'status': Find objects in particular states (draft, open, in-progress, done, wont-do)
'priority': Filter by importance level (high, medium, low)
'includeClosed': Whether to show completed/archived objects (defaults to false)
Usage patterns:
List all tasks in progress: type='task', status='in-progress'
Find high priority work: priority='high', includeClosed=false
Review project scope: type='project', scope='specific-project'
Audit completed work: includeClosed=true, status='done'
Find cancelled items: status='wont-do', includeClosed=true
The results provide object summaries (TrellisObjectSummary instances) containing id, type, title, status, priority, parent, prerequisites, childrenIds, created, and updated fields to enable efficient filtering and further operations.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
includeClosed | No | Include closed objects (defaults to false) | |
priority | No | Priority to filter objects (optional) | |
scope | No | Scope to filter objects (optional) | |
status | No | Status to filter objects (optional) | |
type | Yes | Type of objects to list |