JetBrains / JetBrains/teamcity-cli

Search projects, jobs, and agents by name or ID

Open
#137 1 comment 0 reactions 0 assignees View on GitHub
blocked:needs-api enhancement votes-needed
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.