Search
The search bar sits in the center of the top header on every page. Use it to find systems, resources (models and artifacts), and agents from anywhere in the platform — by name, description, ID, or a set of structured filters.
Open the search bar
- Click the search bar in the header and start typing, or
- Press Cmd + K (macOS) or Ctrl + K (Windows/Linux) from any page to focus it instantly.
The search bar is available everywhere except the Admin area.
When the bar is focused, a dropdown opens beneath it showing the filters available for the current scope.
Choose a scope
On the left of the search bar is a scope selector. It limits what you are searching across:
| Scope | Searches |
|---|---|
| Any (default) | Systems, resources, and agents together |
| Resources | Models and artifacts only |
| Systems | Systems only |
| Agents | Agents only |
Your selected scope is remembered as you navigate between pages, so a search you start on one page carries its scope to the next.
Run a search
- (Optional) Pick a scope.
- Type a search term. The placeholder — "Search by UUID, name and description…" — hints at what plain text matches: a resource or system UUID, a name, or a description.
- Submit your search by pressing Enter or clicking the magnifying glass icon on the right of the bar.
Filter your search
You can narrow results with structured filter tokens typed directly into the bar, in the form token:value (for example, owner:alice status:active). As you type a token, the dropdown suggests values where it can (such as user names for owner:).
The available tokens depend on the scope:
| Token | Meaning | Available in |
|---|---|---|
owner: | Who created it | Any, Resources, Systems |
status: | active or archived | Any, Resources, Systems, Agents |
tag: | Control or branch tag | Systems |
type: | model or artifact | Resources |
ext: | File extension (e.g. stl) | Resources |
mime: | MIME type (e.g. model/stl) | Resources |
version: | Version label (e.g. v1.0.0) | Resources |
display: | Display name | Resources |
external_identifier: | External identifier | Resources |
children: | Has child artifacts (true / false) | Resources |
parent: | Has a parent (true / false) | Resources |
module: | Installed module | Agents |
os: | Operating system | Agents |
version: | Agent version | Agents |
pool: | In a pool (true / false) | Agents |
Note: If branching is enabled on your platform, the
tag:token is replaced bybranch:for filtering by branch name.
View results
Where results appear depends on your scope:
- Any and Resources / Systems searches open a dedicated Search results page with a Systems section and a Resources section.
- A Systems-scoped search filters the Systems list page directly.
- An Agents-scoped search filters the Agents list page directly.
System results
Each system result shows its name, a short description, the creator, and the creation date. Matching text is highlighted. Click a result to open the system.
Resource results
Each resource result shows its name, a type badge (Model or Artifact), the creator, and the last updated date. Click a result to open the file (or artifact) details.
Result limits and paging
To keep results fast, searches return a capped set — up to the first 100 systems and the first 50 resources. When more matches exist than are shown, a note appears next to the section count (for example, "limited to first 100"); refine your search with filters to narrow it down.
Each section pages through its results with Previous and Next controls, showing a count such as "1–6 of 24".
Empty and loading states
- Before you enter anything, the results page prompts you to "Enter a search term or select filters."
- While results load, a spinner is shown.
- When nothing matches, the section reads "No matching systems found" or "No matching resources found."
Clear or close the search
- Click the X in the search bar to clear your query and filters. Your selected scope is kept, so you can immediately start a new search in the same scope.
- Press Escape, or click anywhere outside the bar, to close the dropdown without losing what you typed.
Related
- Systems — open and manage the systems you find.
- Files and Content — open the models and artifacts you find.