## What It Finds

Semantic Search can return:

- [checkpoints](https://docs.entire.io/guides/checkpoints/overview) that captured agent-assisted changes
- sessions with prompts, transcripts, tool activity, and metadata
- commits connected to the captured work

Search combines semantic matching with keyword matching. That means exact phrases can work, but the query can also describe meaning:

```
entire search "auth token refresh"
entire search "how did we decide whether a mission is ready to launch?"
```

## Where to Search

| Surface | Use it when |
| --- | --- |
| [Entire.io](https://docs.entire.io/guides/search/semantic-search/search-in-entire-io) | You want to browse results visually, open checkpoint details, or move between sessions and commits. |
| [Entire CLI](https://docs.entire.io/guides/search/semantic-search/search-in-cli) | You are already in the terminal and want quick results for the current repo or a repo filter. |
| [`search` Skill](https://docs.entire.io/guides/search/semantic-search/search-from-your-agent) | You want your agent to look up relevant history before it starts or while it is investigating. |

## Before You Search

Semantic Search works best when:

- you are authenticated with `entire login`
- the repository has pushed checkpoints or sessions
- Entire has had time to index the latest pushed work
- your query includes specific feature names, bugs, prompts, files, or decisions

If you want a guided setup, follow [Search Past Agent Work](https://docs.entire.io/learn/search-past-agent-work). The tutorial creates a small project, adds searchable checkpoints, and walks through phrase, meaning, web, agent, and cross-repo searches.

## Continue with

[**Search in Entire.io** \
\
Browse semantic search results in the web app.](https://docs.entire.io/guides/search/semantic-search/search-in-entire-io)

[**Search in the CLI** \
\
Use `entire search` from your terminal.](https://docs.entire.io/guides/search/semantic-search/search-in-cli)

[**Search from Your Agent** \
\
Let an agent search past work with the `search` Skill.](https://docs.entire.io/guides/search/semantic-search/search-from-your-agent)

[**Search Past Agent Work** \
\
Practice semantic search with a guided tutorial.](https://docs.entire.io/learn/search-past-agent-work)

[**Semantic Search Troubleshooting** \
\
Fix missing results, repo scoping, login, and agent search issues.](https://docs.entire.io/guides/search/semantic-search/troubleshooting)