Inspector, Search

Global search is the fastest way to navigate a large Neotoma instance. It runs across every record type, entities, observations, sources, conversations, and timeline events, and ranks results so you can jump to the canonical detail page in two keystrokes.

⌘K from anywhere

Press ⌘K on macOS or Ctrl+K elsewhere to open the search modal from any page. Results stream in as you type, grouped by record type, and every result is keyboard-navigable. ↵ opens the canonical detail page; ⌘↵ opens it in a new tab; esc dismisses.

Ranking

Within each record group, matches are ranked by:

1. Identity match, canonical_name equality, then prefix match, then alias match.
2. Snapshot text match, full-text match against the entity snapshot fields.
3. Recency, last_observation_at tie-break, so the most recently touched record wins on ties.

Result kinds

• Entities , matched by canonical_name, snapshot fields, or an existing identifier.
• Observations , full-text search over field_values, scoped by entity.
• Sources , match by filename, mime type, or tool descriptor.
• Conversations , match by title or by content of any contained turn.
• Timeline events , match by entity, agent, or event kind in a time window.

Filters and scoping

Modal-level filters scope the entire search: by entity_type, by agent (thumbprint), or by time window. Per-list pages keep their richer in-page filter chips for narrower work; the global search box is intended for fast navigation, not for exhaustive querying.

Backed by the same API

Every result is fetched against the same endpoints documented under REST API , primarily POST /retrieve_entity_by_identifier and POST /entities/query, alongside listing endpoints for sources, conversations, and timeline events. There is no Inspector-specific search backend; anything you can find in ⌘K is also reachable from MCP and CLI.