JetBrains / JetBrains/teamcity-cli
Search projects, jobs, and agents by name or ID
- Dominant language
- Go
- Stars
- 123
- Forks
- 16
- Avg merge
- 1d 13h
- Merged PRs (30d)
- 22
Description
### Area
Configuration (parameters, projects)
### Problem or use case
On large servers, users need to find projects, jobs, or agents without knowing their exact IDs. Existing structured filters do not provide substring search.
### Proposed solution
Start with case-insensitive substring search on existing list commands: name and ID, plus project description where available. Preserve project scoping and JSON output.
Use server filtering where supported; otherwise paginate before applying client-side matching. Define whether the result limit counts matches and make incomplete searches visible. Verify matches beyond the first page, no matches, case handling, and interaction with existing filters.
On cli.teamcity.com, exact `name:Sandbox` finds Sandbox while `name:(value:Sand,matchType:contains)` returns no matches. This does not block a client-side implementation.
Cross-entity find, ranking, and filtered tree rendering are separate proposals. Schedule this when demand warrants it.
### Alternatives considered
Use list JSON with jq, as shown in the comments, taking care to fetch enough results.
### Contribution
- [ ] I'd be willing to submit a PR (once it's `status:finalized`)
Contributor guide
Assessment
This issue has not been assessed yet.