| name | targetprocess |
| description | Query and manage TargetProcess/Apptio entities (user stories, bugs, tasks, features) via tpcli. Supports discovery, filtering, pagination, entity operations, and complex team-based PI planning scenarios. Use when working with TargetProcess work items, managing project entities, or querying issue trackers for team health and status. |
TargetProcess (tpcli) Skill
Query and manage TargetProcess/Apptio work items and planning data via tpcli.
Prerequisites
tpcli installed and on $PATH- API authentication configured (token + URL via env, config, or flags)
- Read:
references/targetprocess-quick-ref.md for command patterns
Team Scenarios (PI Planning & Health)
Advanced workflows for Lead/Principal Engineers and Agile teams:
- ART Dashboards: See ART-wide PI health.
- Team Deep Dives: Drill into team capacity and risks.
- Objective Analysis: Map dependencies and Jira correlation.
- Release Reports: Track PI status and inter-team blockers.
→ Read references/team-scenarios.md for detailed command patterns.
Bundled Resources
Scripts
scripts/describe-team.sh: Generates a comprehensive team profile (Information, Features, Stories, Bugs, Tasks, and Workload Summary).
Usage:
TP_TOKEN=xxx TP_URL=yyy ./scripts/describe-team.sh [TEAM_ID]
Quick Commands
Discover Available Entities
tpcli discover
Lists all entity types and structure in your TargetProcess instance.
List Entities
tpcli list UserStories
tpcli list Bugs --take 50
tpcli list Tasks --fields Id,Name,EntityState
Filter Results
tpcli list UserStories --where "EntityState.Name eq 'Open'"
tpcli list Bugs --where "Project.Id eq 1234"
tpcli list Features --where "Name like '%dashboard%'"
Pagination
tpcli list UserStories --take 10 --skip 0
tpcli list Tasks --take 50 --skip 50
Get Single Entity
tpcli get UserStory 12345
tpcli get Bug 67890
Plan Discovery
tpcli plan --team "MyTeam"
tpcli plan --art "MyART" --release "Release 2024.1"
tpcli plan discover
Configuration
Set API credentials via environment variables or config file:
export TP_TOKEN="your-api-token"
export TP_URL="https://company.tpondemand.com"
Or create ~/.tpcli.yaml:
token: your-api-token
url: https://company.tpondemand.com
Common Queries
| Task | Command |
|---|
| List all open stories | tpcli list UserStories --where "EntityState.Name eq 'Open'" |
| Find items in project | tpcli list UserStories --where "Project.Id eq 1234" |
| Search by name | tpcli list Features --where "Name like '%search%'" |
| Specific fields only | tpcli list Tasks --fields Id,Name,Priority |
| Limit results | tpcli list Bugs --take 10 |
When to Use This Skill
- Query planning hierarchies (ARTs, teams, releases)
- List and filter work items (stories, bugs, tasks, features)
- Search TargetProcess by name, status, project, etc.
- Discover available entity types and structure
- Integrate TargetProcess data into scripts/reports
When to Read References
For detailed syntax, patterns, and advanced filtering:
→ Read references/targetprocess-quick-ref.md
For API update operations returning 404 or silent failures:
→ Read references/post-vs-put.md — TP API uses POST (not PUT) for updates
For API details and entity structure:
→ Read tpcli documentation: tpcli docs or the installed package documentation
