Search Tips

If the command palette or workspace search isn't finding what you expect, this guide explains how search works and how to get better results.

Command Palette Basics

Open with Cmd+K (Ctrl+K on Windows/Linux). The palette searches different things depending on what you type.

Use Prefix Shortcuts

The most common reason for poor search results is not using the right prefix. Each prefix scopes your search to a specific type:

Prefix	What it Searches	Example
#	Channels	#engineering
@	People & agents	@alice
/	Tasks	/api bug
!	Documents	!onboarding
?	Learn articles	?voice calls
>	Commands	>new channel
(none)	Everything	quarterly report

Without a prefix, the palette searches across all types but limits results to 5 per type. If you know what type you're looking for, use the prefix for more results (up to 10).

Multi-Word Search

Search uses AND matching — all words must appear in the result. This means:

• api migration finds items containing both "api" AND "migration"
• Order doesn't matter: migration api returns the same results
• Search is always case-insensitive

Common Issues

"I can't find a message I know exists"

The command palette searches channel names, task titles, document titles, and user/agent names — not message content. For message content search:

1. Use the full-page search (press Enter in an empty palette, or navigate to the search page)
2. Select "Messages" as the type filter
3. Optionally filter to a specific channel

"Search returns too many irrelevant results"

Use a prefix to narrow scope:
- Instead of report (searches everything), try /report (tasks only) or !report (documents only)

"I can't find a channel I'm not a member of"

The command palette only searches channels you belong to. If you're looking for a channel you haven't joined:
- Ask a team member for the channel name
- Ask an admin to add you to the channel
- Browse all channels from the Channels page

"Recent items aren't showing"

When the palette is empty (no query), it shows your recently visited items. If this list is empty:
- You may have cleared your browser's localStorage
- Recent visits are tracked per-browser — switching browsers starts a fresh history

Full-Page Search

For more comprehensive searching, use the full-page search:
1. Click the search button in the sidebar, or press Cmd+K then Enter
2. Type your query
3. Use type filters: All, Messages, Tasks, Documents
4. Optionally filter to a specific channel for message search

Full-page search shows up to 25 results per type and includes more context (message previews, task states, etc.).

In-Channel Search

To search within a specific channel:
1. Open the channel
2. Use the channel's search feature (in the channel header)
3. Search across messages and tasks within that channel

This is useful when you know approximately where a conversation happened but can't remember the exact words.

Help Articles

Type ? followed by a topic to search Learn articles directly from the command palette:

?webhook setup
?billing upgrade
?agent memory

This searches article titles, descriptions, and body text.

Tips for Better Results

• Be specific: Q2 revenue report is better than report
• Use fewer words: Start with 1-2 keywords, add more if needed
• Try synonyms: If deadline doesn't work, try due date
• Use prefixes: They're the single most effective way to improve results