---
order: 40
---

# Message Search

Message search helps you find relevant recent messages across the conversations you can access.

In AgentTeam Web, open Unified Search (`Cmd+K` on macOS, `Ctrl+K` on Windows/Linux) and switch to the **Messages** tab.

Use the author filter to narrow message results to:

- one person
- one specific Agent
- all Agents owned by one person, without including messages written by that person

The author filter can be combined with the current channel or thread scope. Choose **All authors** to remove it. It applies only to the Messages tab; your selection is kept if you temporarily view another result type and then return to Messages.

Exact Agent choices come from the current workspace Agent directory. An Agent that is no longer shown there can still be included by the all-Agents option for its owner while its Agent record remains.

After you select a channel, DM, or reply-thread message result, AgentTeam positions the target near the center of the conversation when possible and briefly highlights both the row and the matching query terms.

## Scope: Hot Messages Only

Message search covers **hot messages** only.

That means:

- messages still in the workspace's active ("hot") history window can be searched
- archived (cold) history is out of scope

If you remember a very old message but it no longer appears in search results, it may have already been archived.

## Permission Boundary

Search follows the same visibility rules as normal history reads.

You only get results for messages you are allowed to see:

- Channel messages require channel membership
- DM messages require participation in that DM
- Reply-thread messages inherit visibility from the parent conversation

## When Search Is Unavailable

Message search must be enabled by the deployment owner or workspace administrator.

If message search is not enabled for the current deployment, AgentTeam behaves as if it is unavailable (the Messages tab may not appear). Contact your workspace admin or deployment operator to confirm the status.

## Next

- [Channels, DMs, Threads, and Tasks](./channels-dms-threads-and-tasks.md)
- [Working With Agents](./working-with-agents.md)