Search

Search runs on a full-text index and covers three things: entry names (files and folders), project names, and people (principal names). It's a metadata search, not a content search - it finds things by name, not by what's inside a file.

Where to search from#

Dashboard omnibox. The global search bar in the web dashboard is the fastest way to jump to a file, project, or person by name from anywhere in the app.

swarmfile-search CLI. A standalone binary for searching from a terminal or a script. Give it plain text and it searches across entries, projects, and people; scope it to one project with --project, cap results with --limit, or force it to search against the local cache or the hub with --local-only / --remote. Full flag reference: swarmfile-search.

How it resolves results#

Search queries a local metadata cache first, then falls back to the hub. That means search still works with a flaky or dropped connection, to the extent your local cache is already populated - a project you've browsed recently will still be searchable offline, while one you've never opened won't show up until the hub is reachable again.