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:).
Structured filter tokens are available under the Resources, Systems, and Agents scopes — not under Any. The available tokens depend on the scope:
| Token | Meaning | Available in |
|---|---|---|
owner: | Who created it | Resources, Systems |
status: | active or archived | Resources, Systems, Agents |
type: | model or artifact | 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 |
View results
Press Enter to open /search. The page has one Search Results list. The count next to the heading is the number loaded, with a + when more matches exist on the server.
What each result shows
Each row shows the matching name, with highlighted text, and enough context to tell systems, resources, jobs, and modules apart. Click a result to open it.
Paging
Previous, Page X of Y, and Next move through the results already loaded. Load more results fetches the next set from the server. While that request runs, the button reads Loading....
Empty and loading states
- Before you enter a term, the page reads Enter a search term to find systems, resources, jobs, and modules.
- Filters without a search term, outside the Resources scope, read Enter a search term to search all types, or switch to Resources to use these filters.
- While results load, a spinner is shown.
- When nothing matches, the list reads No matching results found.
- If the search fails, the page shows Failed to search. and Retry.
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.
- Find Resources — browse and filter the Resources tree.
- View a Resource — open a model or artifact from a result.