Omics-OS Docs

Command Bar

Unified keyboard-driven search for 8 biological databases, workspace files, and navigation from a single interface

The Universal Command Bar is a keyboard-driven search overlay in Omics-OS Cloud that provides unified access to 8 biological databases, workspace data, the AI assistant, and application navigation from a single interface. It follows the cmdk pattern (similar to Spotlight on macOS or the VS Code Command Palette). Press / or click Search to open it.

Quick Start

Open the Command Bar

Press / on the canvas or click Search in the footer toolbar.

Select a tag

Type a few letters (e.g., prot) and press Tab to select the Protein tag.

Type your query (e.g., TP53). Results appear in real-time.

Select a result

Press Enter or click a result. A canvas node appears automatically with the corresponding data.

Opening the Command Bar

Entry PointHowNotes
Search buttonClick Search in the canvas footer toolbarPrimary entry point for mouse users
/ hotkeyPress / when the canvas has focusDoes not fire when typing in chat or input fields
Pathway double-clickDouble-click a gene, enzyme, or compound in a pathway diagramOpens pre-filled with that entity's tag and query

The command bar uses a two-step search model: first select a tag to scope the search domain, then type your query within that domain. This prevents ambiguity (e.g., "TP53" could be a gene, protein, or literature search) and routes requests to the correct backend.

Biological Databases (8 tags)

TagWhat It SearchesWhat It CreatesExample Queries
ProteinUniProt (reviewed entries)3D structure (Mol*) or InfoCardTP53, P04637, insulin receptor
GeneNCBI Gene (human-first)Gene InfoCardBRCA1, EGFR, HER2/neu
StructureRCSB PDB3D structure (Mol* viewer)ribosome, 1CRN, kinase
LiteraturePubMedCitation InfoCardCRISPR, "single cell sequencing"
CompoundChEMBLCompound InfoCardaspirin, imatinib, CHEMBL25
DatasetNCBI GEODataset InfoCardsingle cell RNA, PBMC scRNA
PathwayKEGG PathwaysInteractive pathway mapglycolysis, MAPK, mTOR
SequenceNCBI NucleotideCircular/linear genome mappUC19, E. coli K-12, SARS-CoV-2

Workspace Tags (3 tags)

TagWhat It SearchesAction
FileVisualization-capable files (.pdb, .cif, .bam, .vcf, .gbk)Opens as canvas viewer node
PlotPlots from current sessionMaterializes or scrolls to plot
SessionAll user sessionsSwitches to selected session

Action Tags (3 tags)

TagWhat It DoesAction
LobsterNatural language AI promptOpens chat with query pre-filled
CommandSlash commands (/help, /status, /tokens, etc.)Executes the selected command
NavigateApp destinations (Files, Agents, Settings, etc.)Opens the corresponding panel

Keyboard Shortcuts

No tag selected:

KeyAction
Type textFuzzy-matches tag suggestions
Tab / EnterSelects highlighted tag
Arrow Up/DownNavigate tag suggestions
EscapeCloses command bar

Tag selected:

KeyAction
Type textSearches the selected database
EnterExecutes highlighted result
Arrow Up/DownNavigate search results
Backspace (empty input)Clears tag, returns to tag selection
EscapeFirst press: clears tag. Second press: closes bar

Canvas Nodes

Each search result creates a specific node type on the canvas:

SourceNode TypeSizeInteractive?
Protein (with PDB match)MolstarNode1200x800Rotate, zoom, measure, change style
Protein (no PDB match)InfoCard400x300Static with external UniProt link
GeneInfoCard400x300Static with NCBI link
StructureMolstarNode1200x800Full Mol* controls
LiteratureInfoCard400x300PubMed link
CompoundInfoCard400x300ChEMBL link
DatasetInfoCard400x300GEO link
PathwayPathwayNode1200x800Click entities, zoom, layout controls
SequenceCgviewNode800x800Zoom, rotate, feature highlight

All nodes auto-position to avoid overlaps with existing canvas content.

Chat Mutual Exclusivity

The command bar and the chat modal cannot be open simultaneously. Opening one automatically closes the other. This prevents keyboard shortcut conflicts and visual overlap on the canvas.

Troubleshooting

/ key does not open the command bar --- The canvas must have focus. Click on the canvas background first, then press /. The hotkey is disabled inside chat input fields and text editors.

No results found --- Try alternative names or accession IDs. For example, use P04637 instead of TP53 for an exact UniProt match. Quoted phrases (e.g., "single cell sequencing") enable exact-match search in Literature.

Slow results --- Search input has a 300ms debounce to avoid excessive API calls. Results are cached for 60 seconds, so repeat searches return instantly.

On this page